작은숲:공책/웹 사이트/위키 문서 잘 쓰는 법

공책 문서입니다. 독자연구성 서술이나 난해한 서술이 있을 수도 있음에 유의해주세요.

문서 잘 만드려면 다음과 같은 방식을 지키는 것이 좋다.

목적은 명확하게

글을 쓰는 목적은 명확하게 표현해야 좋은 글이다. 예를 들면 위키 문서는 분명한 정보 전달의 목적이 있는 만큼 독자들에게 전달하고 싶은 이야기를 간결하게 요약하는 것이 필요하다.

가급적 두괄식으로 작성

위키 문서는 무한정 길어질 수 있고, 이용자들이 문서 전체를 제대로 읽어보지 않는 경향이 있다. 맨 먼저 위키 문서의 주제를 밝히는 것이 독자들을 배려하는 것이다. 한국어 위키백과에서 문서가 설명하는 대상에 대해 정의하는 문구을 맨 앞에 넣는 것도 대표적인 예다.

단 짧은 서술만 가진 문단은 오히려 미괄식으로 서술하는 게 도움이 될 수 있다. 이용자들이 마지막까지 글을 읽을 가능성이 있기 때문이다.

문단을 나누어 서술할 것

문단은 거의 대부분의 위키는 각 문서 안에 문단을 나눌 수 있는 기능이 있다. 또한 문단의 제목을 명시하는 기능이 있다. 이런 구조를 살려서 각 문단은 문서가 설명하는 소재의 세부 내용을 나누어서 서술할 수 있다.

문단의 주제는 한 문단에 하나씩만

독자들은 문단 제목을 통해 글의 내용을 판단한다. 한 문단에 확실히 하나의 주제를 명시해야 글의 의도를 파악하는데 도움이 된다.

문단 제목에 문법효과 사용은 자제할 것

(추가예정)