# 문서 개선을 위한 다음 단계
**URL:** https://meta.discourse.org/t/next-steps-for-improving-our-documentation/240134
**Category:** Site feedback
**Created:** [9월 27, 2022, 8:00오후 UTC](https://meta.discourse.org/t/next-steps-for-improving-our-documentation/240134 "2022-09-27T20:00:36Z")
**Posts on this page:** 2
**Page:** 1
### Author:  [@mcwumbly](https://meta.discourse.org/u/mcwumbly)
#### Post date: [9월 27, 2022, 8:00오후 UTC](https://meta.discourse.org/t/next-steps-for-improving-our-documentation/240134/1 "2022-09-27T20:00:36Z")
최근 우리는 메타(meta)의 문서를 개선하기 위해 노력하고 있으며, 다양한 사용자가 자신에게 관련 있는 주제를 쉽게 찾고 관련 없는 주제는 무시할 수 있도록 카테고리를 분류하는 데 중점을 두고 있습니다.
모든 문서가 다음 카테고리 중 하나에 포함되도록 하겠습니다:
- #documentation:users - 일반적인 사용법
- #documentation:moderators - 커뮤니티 관리(모더레이션)
- #documentation:theme-developers - 테마 및 테마 컴포넌트 개발
- #documentation:admins - Discourse 사이트 관리
- #documentation:devs - Discourse 기능, 플러그인 및 통합 개발
- #documentation:sysadmin - 셀프호스팅 시스템 관리
이번 달 말까지 #documentation:faq와 #documentation:tips-and-tricks 카테고리를 제거할 계획입니다(다만, 일부 주제에는 이미 새 카테고리와 함께 #tips-and-tricks 태그를 붙이기 시작했습니다).
또한 [이전 게시물](https://meta.discourse.org/t/how-to-write-a-howto/178575/)에서 divio에서 가져온 다음 분류 태그 중 하나로 문서에 태그를 붙이는 것을 목표로 합니다:
- #how-to
- #tutorial
- #explanation
- #reference
항상 완벽하게 분류되는 것은 아닙니다. 일부 경우에서는 주제를 나누고, 다른 경우에서는 현재 상태에 가장 잘 맞는 태그나 카테고리를 사용합니다.
현재까지 개별 주제에 대해 수행한 일반적인 변경 사항들입니다(현재 약 50% 완료 상태입니다).
- 콘솔 접근이 필요한 경우 #documentation:admins에서 #documentation:sysadmin으로 이동.
- #documentation:faq 주제를 #documentation:admins용 주제와 #documentation:users용 주제로 분리.
- 테마 또는 테마 컴포넌트 개발에 특화된 경우 #documentation:devs에서 #documentation:theme-developers로 이동.
- 주제 제목을 더 일관되게 업데이트
- 주제 제목에 명령형 시를 사용(제목에서 “how to” 제거).
- 일반적인 문장 대소문자 규칙 사용
- H2 헤딩부터 시작하는 헤딩으로 콘텐츠 포맷팅
(관련: 모든 문서 주제에 대해 목차(Table of Contents)도 활성화했습니다)
일부 경우 콘텐츠 자체에 변경을 가하고 있지만, 심층적인 수정은 당장의 목표가 아닙니다. 향후 작업에서는 다음과 같은 것들을 수행하고자 합니다:
- 답변의 내용을 문서 본문에 통합
- 모든 답변 삭제
- 답변이 1~2개월 후 자동 삭제되도록 주제 설정
그리고 앞으로는 새로운 문서 기여 및 기존 문서 유지 관리에 대한 업데이트된 지침을 제공하고, 다음 주제들을 업데이트할 것입니다:
- [Writing effective how-to documentation](https://meta.discourse.org/t/how-to-write-a-howto/178575)
- [Contributing to Discourse](https://meta.discourse.org/t/contributing-to-discourse/53797)
원저자가 아닌 다른 사람이 문서를 유지 관리하는 경우 등, 문서를 위키(Wiki)로 전환하거나 새로운 관리자를 찾는 것도 고려할 수 있습니다.
* * *
또한 #documentation:tips-and-tricks에 있던 일부 콘텐츠와 유사한 "시연 및 소개(show and tell)"를 위한 별도의 공간을 마련할 기회가 있을 수 있다고 생각합니다. 문서 밖에서 이러한 주제에 대한 공간을 마련하면 동료들 간의 토론을 위한 더 많은 여유가 생길 수 있습니다. 하지만 현재 문서에서처럼, 이러한 토론을 위해 시스템 관리자, 관리자, 개발자를 위한 별도 공간을 마련하는 것이 도움이 될 수 있습니다. 여러분의 생각은 어떠신가요?
---
### Author:  [@mcwumbly](https://meta.discourse.org/u/mcwumbly)
#### Post date: [10월 20, 2022, 8:09오후 UTC](https://meta.discourse.org/t/next-steps-for-improving-our-documentation/240134/33 "2022-10-20T20:09:04Z")
위에서 언급한 계획에 따라 #documentation의 자료를 재분류하는 전체 작업을 완료했다는 점을 간단히 공유드립니다.
지금까지 진행된 작업에 대해 피드백이나 질문이 있으시면 언제든지 여기에 남겨주세요.
아직 그 이후의 즉각적인 다음 단계는 계획되어 있지 않지만, 몇 가지 아이디어를 검토하고 있습니다.