문서 카테고리의 홈 페이지는 무엇이어야 하나요?

Documentation > Site Management 를 클릭했을 때, 최신 주제 대신 인덱스로 이동하는 것이 더 적절하지 않을까요?

아니면, 사용자가 지정한 다른 “개요” 주제로 이동하도록 하는 것이 어떨까요?

우리는 발견 가능성을 높이기 위해 카테고리 설명에 인덱스를 직접 링크해 왔습니다:

관련 토론

아니면 현재 상태가 괜찮은 걸까요? 인덱스가 이미 사이드바에 있으므로 중복된 것처럼 보일 수 있지만, 현재 설계에 대해 두 가지 측면에서 약간 어색하게 느껴집니다:

  • 인덱스 자체를 찾기 어렵습니다.
  • 특정 주제에 진입한 후 문서 탐색 방식과 비교할 때 최신 주제 목록이 약간 혼란스럽습니다.
6개의 좋아요

인덱스가 문서에 대한 더 나은 진입점이 될 수 있을지 궁금합니다. 제가 보는 문제는 인덱스 페이지든 사이드바든 문서 주제를 실제로 훑어보고 탐색하기가 어렵다는 점입니다:

명백한 해결책이 있는지는 잘 모르겠습니다. 기존 문서 플랫폼에서 더 나은 사이드바 레이아웃을 위한 패턴들이 있습니다. 하지만 실제 주제 구성에 대한 추가 작업 없이도 우리의 경우를 개선할 수 있을까요? 커뮤니티 위키 전체에는 잘 맞지 않을 수도 있습니다.

현재의 좁은 왼쪽 사이드바 대신, 목차 레이아웃에 더 가까운 오른쪽 사이드바가 더 나을 수도 있을까요?

4개의 좋아요

저도 이 문제에 대해 생각해 보고 있습니다. meta.discourse.org와는 별개로, 문서 카테고리 플러그인에 대한 일반적인 필요성으로 볼 수 있습니다. 많은 경우에서 인덱스 페이지에 도달하는 것이 훨씬 좋으며, 카테고리에서 시작했을 때 사이드바의 내용이 변경되었음을 인식하지 못하다가 주제(topic)에 진입할 때까지 알아차리지 못하는 경우가 많을 수 있으므로, 사이드바의 내용을 더 명확하게 이해하는 데 도움이 될 것이라고 생각합니다.

플러그인에 카테고리를 기준으로 이 기능을 활성화할 수 있는 옵션이 있다면 좋겠습니다. 이렇게 하면 여기에서 언급된 것과 같이 목록이 매우 긴 경우 비활성화할 수 있고, 다른 경우에는 활성화할 수 있을 것입니다.

1개의 좋아요

오늘 이 문제에 대해 좀 더 자세히 살펴보았습니다. 플러그인에 설정을 추가하는 pull request를 만들지 고민하고 있었습니다. 이 설정을 활성화하면, 카테고리 직접 링크가 해당 카테고리의 문서 인덱스로 브라우저가 리다이렉트되도록 강제하는 방식입니다. 플러그인의 기존 작업을 살펴보다가, 현재 진행 중인 훨씬 큰 규모의 기능 재구성을 발견했습니다: FEATURE: Add visual doc category index editor - Pull Request #87 - discourse/discourse-doc-categories - GitHub

문서 인덱스를 카테고리 목록으로 사용하는 이러한 선택적 기능을 추가하기에 최적의 시점인 것 같습니다. 동시에 @sam이 업데이트 내에서 개발 중인 "Simple Mode"와 충돌할 수도 있습니다. Sam, 위에서 설명한 옵션이 Simple Mode 작업이나 PR에서 인덱스를 구축하기 위한 더 많은 옵션을 제공하는 더 큰 작업에 적합할 수 있다고 보시는지 궁금합니다. 개발 중인 단순화된 컬럼 구성을 선택하거나, 단순히 인덱스 주제만 사용할 수 있다면 정말 멋질 것 같습니다. 이상적으로는 게시물의 내용이 카테고리의 전체, 일반 또는 단순 목록 위에 표시되는 것이 가장 좋겠습니다.

1개의 좋아요

이미 이 기능 요청이 있다는 것을 몰랐고, 여기서 비슷한 요청을 했습니다:

현재 랜딩 페이지보다 인덱스 페이지를 사용하는 것이 더 좋다는 데 동의합니다.

다른 문서 플랫폼에서 봤지만 현재 Discourse 문서에는 없는 항목 중 하나는 인덱스의 이전/다음 페이지에 따라 자동으로 표시되는 이전/다음 버튼입니다. 이는 사용자가 인덱스/목차 페이지로 돌아가거나 사이드바를 사용할 필요 없이 주제를 예상된 순서대로 살펴볼 수 있도록 도와줍니다. 예를 들어:

6개의 좋아요

현재 카테고리에서 인덱스 페이지로 이동하는 것이 합리적이라고 저도 동의합니다. 최종적으로는 토픽으로 이동하는 것보다, 인덱스를 기반으로 구축된 새로운 UI로 실제 페이지를 표시하는 것이 더 나을 수도 있습니다.

이것은 우리 문서에 정말 멋진 아이디어입니다!

2개의 좋아요