매뉴얼 개편에 많은 관심이 필요합니다.
https://github.com/rhymix/rhymix-docs/issues/17
Github의 공식 매뉴얼 저장소 이슈에도 올렸습니다.
그동안 정말 많!은 비공식적 매뉴얼 혹은 작성해주신 문서들이 있습니다만, 다음과 같은 문제점이 있습니다.
1. 정보가 파편화되어 접근성이 매우 떨어집니다(중요)
2. 매뉴얼 작성자들마다 동일한 기준을 잡고 작성하지 않아서 매뉴얼을 읽는 사람들이 혼동이 옵니다.
3. 혼자 작성하여 의욕이 떨어지기도 하고, 혼자 많은 양을 작성하기에 상당히 버겁습니다.
4. 비공식 매뉴얼은 유지보수가 안됩니다!!!!(매우중요)
그래서 다음과 같은 이유로 제가 감히 기준을 다시 잡았습니다.
- 코어 개발자의 영역과 커뮤니티가 해야 될 영역이 나뉘어야 한다고 봅니다. 매뉴얼이 처음부터 잘 작성되어있었다면 괜찮겠지만, 처음부터 매뉴얼 작성이 삐그덕 거린 XE를 이어받아버린 이상, 제 기준에선 커뮤니티의 영역이라고 봤습니다.
- 좋은 개발 커뮤니티를 만들기 위해서는 좋은 튜토리얼/매뉴얼이 최선임을 Vue를 보고 확신하였습니다.
- 이용자/디자이너/개발자 매뉴얼로 분할하여 특정 기준의 사용자가 파편화된 복잡한 정보를 얻고 러닝커브로 느낄만한 부분들을 없앴습니다.
- 매뉴얼과 튜토리얼로 분할하여 사용자가 읽으며 확인할 내용과 읽으며 천천히 따라할 수 있는 두 부류로 나눴습니다.
당연히 현재 분류조차 100% 완성 안되었지만, 과감하게 한번 밀어붙여봅니다.
매뉴얼 작성을 도와주실분들을 구합니다!
댓글 2
https://github.com/damoang-users/rhymix-guide/pull/3
최근에 비공식 매뉴얼에 기여를 했었는데, 정리엔 소질이 없어서 그런지 저 정도 분량을 작성하는데도 한 세월이 걸리더군요 ㅎ..
매뉴얼에 큰 갈래가 잡힌다면 조금씩 기여할 것 같습니다.
응원합니다!
특히 신규 초보 유입자들에게 도움이 되는 정보면 더욱 좋겠습니다 .
라이믹스 사용을 하고 있지만
예를 들어서 관리자 페이지에 SEO 설정하는곳이 2곳 있습니다
두 곳의 SEO 설정은 각각 어떤 역할을 하는 것인가요? (예: 어떤 영역에 영향을 미치는지)
SEO 효과를 제대로 보려면 두 곳 모두 설정을 해야 하는 건가요? 아니면 한 곳에만 적용해도 충분한가요? 같은 의문입니다.