현재 위치

홈 ›› 블로그 ›› gurugio의 블로그

공개 문서를 만들때 지켜야 할 사항들이 무엇인가요?

gurugio의 이미지
글쓴이: gurugio / 작성시간: 금, 2005/12/16 - 7:30오후

자유게시판에도 올렸지만 답변이 적어서 여기도 글을 올립니다.
제가 u-boot라는 부트로더를 PXA270 보드에
포팅하는 과정을 적은 문서를 만들고 있는데요

제가 참고했던 다른 문서나 웹 페이지등등의 글들을
어떻게 인용해야 하는지
그리고 GPL을 따른다고 할때
어떤 문구를 추가시켜야 하는지등등

공개 문서를 만들 때 지켜야 할 사항들에 대해서
가르쳐주시면 정말 감사하겠습니다.

모두 바쁘신 분들이라서 이런 부탁 드리기가 어렵지만
최소한 어디에 관련 정보가 있다는 것이라도 알려주시면 좋겠습니다.

댓글

gurugio의 이미지

글쓴이: gurugio / 작성시간: 토, 2005/12/17 - 2:17오후

새 위키 문서를 만들려면 Goto를 누르라는데
그게 뭔지 몰라서 결국 페이지를 생성하는데 30분이 걸렸네요

지금 생각으로는 생성된 페이지 지우고
그냥 PDF로만 만들어서 공개고 뭐고
연구실 자료로만 남겨놔야겠습니다.

웹이라는게 참 어렵네요.
그냥 땜질하러 가야겠습니다.
갠히 메뉴얼보면 나와있는거 질문드려서 죄송합니다.

wkpark의 이미지

글쓴이: wkpark / 작성시간: 토, 2005/12/17 - 2:48오후

gurugio wrote:
새 위키 문서를 만들려면 Goto를 누르라는데
그게 뭔지 몰라서 결국 페이지를 생성하는데 30분이 걸렸네요

지금 생각으로는 생성된 페이지 지우고
그냥 PDF로만 만들어서 공개고 뭐고
연구실 자료로만 남겨놔야겠습니다.

웹이라는게 참 어렵네요.
그냥 땜질하러 가야겠습니다.
갠히 메뉴얼보면 나와있는거 질문드려서 죄송합니다.


겨우 30분인가요? 저는 처음 위키 적응할때 엄청난 시간을 소모했습니다. 지금은 그때 어떻게 적응했었는지 기억조차 나지 않습니다.
뭐든 다 똑같습니다. 시작할때는 너무 힘들지만 하고나면 아무것도 아닌게 됩니다.

온갖 참된 삶은 만남이다 --Martin Buber

NN의 이미지

글쓴이: NN / 작성시간: 토, 2005/12/17 - 4:12오후

너무 어렵게 생각하시는거 아닌가요? 먼저 참조할만한 이미 검증된 well-defined 도큐먼트를 찾아 그것을 따라가는것이 좋을듯 합니다.

그런것들을 찾기가 어렵다면, 본인이 생각하기에 이런것을 포함시키고 저런것은 빼도 좋겠다는 판단을 통해 최대한 정성을 들여 문서를 만든다음 초기버전으로 릴리즈하고, 추후 feedback을 통해 개정해가면서 수정보완하는것이 좋지 않을까 싶네요.

어쨋든 "공개용 문서는 이렇게 작성해야 한다"라는건 없는거니까... 형식은 자유롭게 하셔도 될것 같은데...

댓글 달기

텍스트 포맷에 대한 자세한 정보

Filtered HTML

  • 텍스트에 BBCode 태그를 사용할 수 있습니다. URL은 자동으로 링크 됩니다.
  • 사용할 수 있는 HTML 태그: <p><div><span><br><a><em><strong><del><ins><b><i><u><s><pre><code><cite><blockquote><ul><ol><li><dl><dt><dd><table><tr><td><th><thead><tbody><h1><h2><h3><h4><h5><h6><img><embed><object><param><hr>
  • 다음 태그를 이용하여 소스 코드 구문 강조를 할 수 있습니다: <code>, <blockcode>, <apache>, <applescript>, <autoconf>, <awk>, <bash>, <c>, <cpp>, <css>, <diff>, <drupal5>, <drupal6>, <gdb>, <html>, <html5>, <java>, <javascript>, <ldif>, <lua>, <make>, <mysql>, <perl>, <perl6>, <php>, <pgsql>, <proftpd>, <python>, <reg>, <spec>, <ruby>. 지원하는 태그 형식: <foo>, [foo].
  • web 주소와/이메일 주소를 클릭할 수 있는 링크로 자동으로 바꿉니다.

BBCode

  • 텍스트에 BBCode 태그를 사용할 수 있습니다. URL은 자동으로 링크 됩니다.
  • 다음 태그를 이용하여 소스 코드 구문 강조를 할 수 있습니다: <code>, <blockcode>, <apache>, <applescript>, <autoconf>, <awk>, <bash>, <c>, <cpp>, <css>, <diff>, <drupal5>, <drupal6>, <gdb>, <html>, <html5>, <java>, <javascript>, <ldif>, <lua>, <make>, <mysql>, <perl>, <perl6>, <php>, <pgsql>, <proftpd>, <python>, <reg>, <spec>, <ruby>. 지원하는 태그 형식: <foo>, [foo].
  • 사용할 수 있는 HTML 태그: <p><div><span><br><a><em><strong><del><ins><b><i><u><s><pre><code><cite><blockquote><ul><ol><li><dl><dt><dd><table><tr><td><th><thead><tbody><h1><h2><h3><h4><h5><h6><img><embed><object><param>
  • web 주소와/이메일 주소를 클릭할 수 있는 링크로 자동으로 바꿉니다.

Textile

  • 다음 태그를 이용하여 소스 코드 구문 강조를 할 수 있습니다: <code>, <blockcode>, <apache>, <applescript>, <autoconf>, <awk>, <bash>, <c>, <cpp>, <css>, <diff>, <drupal5>, <drupal6>, <gdb>, <html>, <html5>, <java>, <javascript>, <ldif>, <lua>, <make>, <mysql>, <perl>, <perl6>, <php>, <pgsql>, <proftpd>, <python>, <reg>, <spec>, <ruby>. 지원하는 태그 형식: <foo>, [foo].
  • You can use Textile markup to format text.
  • 사용할 수 있는 HTML 태그: <p><div><span><br><a><em><strong><del><ins><b><i><u><s><pre><code><cite><blockquote><ul><ol><li><dl><dt><dd><table><tr><td><th><thead><tbody><h1><h2><h3><h4><h5><h6><img><embed><object><param><hr>

Markdown

  • 다음 태그를 이용하여 소스 코드 구문 강조를 할 수 있습니다: <code>, <blockcode>, <apache>, <applescript>, <autoconf>, <awk>, <bash>, <c>, <cpp>, <css>, <diff>, <drupal5>, <drupal6>, <gdb>, <html>, <html5>, <java>, <javascript>, <ldif>, <lua>, <make>, <mysql>, <perl>, <perl6>, <php>, <pgsql>, <proftpd>, <python>, <reg>, <spec>, <ruby>. 지원하는 태그 형식: <foo>, [foo].
  • Quick Tips:
    • Two or more spaces at a line's end = Line break
    • Double returns = Paragraph
    • *Single asterisks* or _single underscores_ = Emphasis
    • **Double** or __double__ = Strong
    • This is [a link](http://the.link.example.com "The optional title text")
    For complete details on the Markdown syntax, see the Markdown documentation and Markdown Extra documentation for tables, footnotes, and more.
  • web 주소와/이메일 주소를 클릭할 수 있는 링크로 자동으로 바꿉니다.
  • 사용할 수 있는 HTML 태그: <p><div><span><br><a><em><strong><del><ins><b><i><u><s><pre><code><cite><blockquote><ul><ol><li><dl><dt><dd><table><tr><td><th><thead><tbody><h1><h2><h3><h4><h5><h6><img><embed><object><param><hr>

Plain text

  • HTML 태그를 사용할 수 없습니다.
  • web 주소와/이메일 주소를 클릭할 수 있는 링크로 자동으로 바꿉니다.
  • 줄과 단락은 자동으로 분리됩니다.
댓글 첨부 파일
이 댓글에 이미지나 파일을 업로드 합니다.
파일 크기는 8 MB보다 작아야 합니다.
허용할 파일 형식: txt pdf doc xls gif jpg jpeg mp3 png rar zip.
CAPTCHA
이것은 자동으로 스팸을 올리는 것을 막기 위해서 제공됩니다.