개발 중인 새로운 문서 플러그인

최근 새로운 문서 플러그인을 테스트 및 피드백을 위해 공개했습니다. 이 플러그인은 Discourse에 호스팅된 문서의 탐색과 접근성을 향상시켜 모든 사용자에게 더 편리하고 친근한 경험을 제공하는 것을 목표로 합니다. 이 플러그인은 아직 개발 중입니다.

이 플러그인의 개발은 문서 개선을 위한 우리의 지속적인 노력에서 비롯되었습니다. 이 노력은 이미 새로운 사이드바를 통해 향상되었습니다. 사이드바 작업은 훨씬 개선된 문서 경험을 위한 토대를 마련했으며, 새로운 플러그인은 그 작업을 기반으로 점진적으로 발전시키고 있습니다.

:boom: 새로운 플러그인 동작

현재 이 플러그인은 활성화되어 있으며, 공식 Discourse 문서의 문서를 제공하고 있습니다. 기능을 탐색하고 여러분의 경험을与我们 공유해 주시길 바랍니다. 여러분의 피드백은 플러그인을 정교하게 다듬고 개선하는 데 매우 중요합니다.

새로운 플러그인에 포함된 핵심 기능은 다음과 같습니다:

  • 문서로 사용할 카테고리를 정의하는 설정
  • 각 카테고리 내의 인덱스 토픽으로 구성된 새로운 문서 사이드바
  • 인덱스 토픽의 무결성과 정확성을 유지하는 데 도움이 되는 두 가지 새로운 리포트

우리는 지속적으로 사용 가능한 기능을 개선하고 있으며, 더 많은 기능이 개발 중입니다.

새로운 플러그인은 오늘부터 다운로드 및 설치할 수 있습니다: Discourse Doc Categories

:electric_plug: Discourse Docs 플러그인에서 전환

우리가 혁신하고 나아가면서, 기존 Discourse Docs 플러그인은 종료될 예정입니다. 하지만 새로운 플러그인이 광범위한 배포에 완전히 준비될 때까지 기존 플러그인에 대한 지원을 계속할 것이므로 안심하셔도 됩니다. 또한 새로운 플러그인이 기존 플러그인의 URL을 리다이렉트하도록 조치하여, 전환 시 깨진 링크가 발생하지 않도록 했습니다.

새로운 플러그인은 여전히 실험 단계임을 유의해 주세요. 원활한 경험을 제공하고자 하지만, 추가적인 개선이 필요한 부분이 있을 수 있습니다. 여러분의 건설적인 피드백은 성공에 필수적입니다.

:speaking_head: 의견을 알려주세요

여러분의 생각, 경험, 피드백을 환영합니다. Meta에서 문서를 탐색하거나, 여러분 자신의 사이트에 플러그인을 설치하여 새로운 문서 플러그인을 사용하면서 얻은 경험과 통찰을 자유롭게 공유해 주세요.

우리의 목표는 Discourse 커뮤니티 전체를 위해 더 나은 문서 경험을 만드는 것이므로, 모든 피드백을 환영합니다!

플러그인 전체 세부 정보:

13개의 좋아요

누군가 readme를 업데이트해야 합니다. 그리고 이 일이 다시 일어나지 않도록 lint 규칙도 업데이트하면 좋겠지만, 계란과 닭 문제(순환적 의존성)가 있습니다.

Discourse를 LMS(학습 관리 시스템)로 사용하는데도 훌륭할 것 같습니다. 이를 위해 문서 카테고리를 자유롭게 전환할 수 있는 기능이 있으면 좋겠지만, 단순히 권한을 통해 사용자가 특정 카테고리에 접근할 수 있도록 설정하는 것만으로도 충분히 잘 작동할 가능성이 높습니다.

8개의 좋아요

URL을 잘 짚어주셨네요 - 방금 그걸 추가하기 위해 PR을 제출했습니다.

흥미로운 활용 사례인 것 같고, 꽤 잘 작동할 것 같네요!

6개의 좋아요

기존 문서/지식 베이스 플러그인보다 훌륭한 개선입니다. 지금까지 사용해 본 결과, 사용자 친화적인 것 같습니다.

메타에서 테스트할 수 있다는 점은 분명 큰 장점입니다. 이전에는 문서 카테고리에서 필요한 항목을 찾기가 어려웠거든요.

5개의 좋아요

대단히 죄송하지만, 예상 완료 시점(ETA)을 여쭤봐도 될까요? 즉, 이 플러그인이 실험적 단계에서 벗어나 베타, 혹은 초기 릴리스 후보(early release candidate) 단계로 넘어갈 시기를 묻는 것입니다. 미래를 예측하는 것이 얼마나 어려운지 잘 알고 있으니, 아무리 부정확하더라도 대략적인 추정치라도 알려주시면 감사하겠습니다. :wink:

현재 저는 직장 내에서 Discourse를 도구로 활용하는 방안을 검토 중입니다. 이는 커뮤니티 토론과 문서 공유 공간을 잘 혼합하여 제공할 수 있을 것 같기 때문입니다. 토픽에 댓글을 남기는 것과 마찬가지로 문서 작성도 쉽게 이루어질 수 있어야 하니까요.

물론 위키 토픽 기능 자체는 훌륭하고, 좋은 출발점이라고 생각합니다. 하지만 이 플러그인은 토픽 콘텐츠의 일관성을 더해주며, 저는 이것이 문서의 사용자 경험에 있어 필수적이라고 믿습니다.

meta.discourse.org의 Documentation 카테고리는 이제 단순한 포럼 토픽들이 우연히 같은 카테고리를 공유하고 우연히 Discourse 작동 방식을 설명하는 것이 아니라, 제대로 구조화된 문서 사이트처럼 느껴집니다.

그래서, 좋은 작업을 계속해 주세요. 감사합니다!

1개의 좋아요

정말 좋아합니다! 문서화와 토론이 아주 잘 어울리네요.

카테고리 외에 태그 인덱싱도 활성화할 계획이 있으신가요?

현재 우리가 있는 단계는 "아름다움(또는 그 부재)은 보는 사람의 눈에 달려 있다"는 표현이 어울릴 것 같습니다.

이것은 문서 유지보수를 담당하는 사람들, 특히 인덱스를 관리하는 사람들에게 알려진 UX 문제가 있기 때문에 실험적인 단계라고 할 수 있습니다. 하지만 프로덕션 환경에서 사용하는 것은 완전히 _안전_합니다.

즉, 직접 사용해 보고 테스트해 보신다면 여러분의 피드백을 매우 환영합니다.

인덱스 유지보수와 관련된 알려진 UX 문제를 개선하기 위한 예상 완료 시점은 현재로서는 없습니다. 하지만 이를 사용하는 사람들의 피드백이 해당 방향성을 설정하는 데 도움이 될 수 있습니다.

아니요, 아직 어디에서도 언급된 적이 없는 사항입니다. 여러분이 생각하고 계신 내용이나 이것이 왜 도움이 될지 조금 더 자세히 공유해 주시겠습니까?

4개의 좋아요

이와 관련하여: 문서 카테고리 페이지에 있을 때 전체 화면이 아닌 채팅 창을 닫으면, 문서 내비게이션도 함께 “닫히게” 되고 다시 일반 내비게이션 바가 표시됩니다. 메타에서 재현되는 것을 확인했으며, 채팅 버블(오른쪽 상단 헤더)을 클릭해도 문서 내비게이션이 닫히는 것을 발견했습니다. 도움이 되길 바랍니다!

3개의 좋아요

리포트해 주셔서 감사합니다. 재현이 가능하여 문제를 기록했으며, 예정된 개발 작업에 포함할 예정입니다.

3개의 좋아요

이로 인해 Discourse 프로젝트에 대해 사용자로서 조금 마음에 들지 않는 한 가지가 떠올랐습니다. 바로 버그 및 계획 관련 사항을 위한 적절한 공개 이슈 트래커를 사용하지 않는다는 점입니다.

예를 들어, Hugh의 답변을 읽었을 때 내 안의 프로젝트 매니저가 즉시 이런 질문을 던졌습니다. 이것이 어디에 기록되었나요?. 아, 제 내면의 PM은 참 간섭이 심한 작은 생물이지 않나요? :slight_smile:

meta.discourse.org를 이슈 트래커로 사용하는 것이 Discourse 프로젝트에 Discourse를 직접 사용해보는 "도그푸딩"의 기회를 제공한다고 생각합니다. 그리고 다른 모든 이슈 트래커도 각자의 단점이 있어 하나를 선택하는 것이 번거롭긴 합니다. 하지만 저에게 Discourse는 질문과 토론을 위한 포럼으로는 훌륭하지만, 이슈 트래커로서의 기능은 매우 부족합니다. 이를 위해서는 상태, 경과, 우선순위, 제품 또는 컴포넌트별로 이슈를 효과적으로 필터링할 수 있는 수단, 이슈 번호, 영향 받는 버전 및 대상 버전 정보, 우선순위 설정, 특정 기능이나 제품 전체의 로드맵을 잘 제시하는 방법 등이 부족합니다.

글쎄요, 주제에서 좀 벗어났네요. 그리고 아직 코드 한 줄, 버그 리포트, 기능 요청도 한 적이 없으니 제가 뭐라고 불평할 수 있겠나 싶습니다. :wink:

다시 한번, Discourse의 놀라운 점에 대해 모두에게 감사드립니다. 그리고 이런 반쯤 투정 섞인 글에 대해 양해 부탁드립니다.

주제로 돌아가자면, 아직 다듬어지지 않았지만 Discourse Doc Categories가 아키텍처적으로 안정적이라고 평가받는다는 소식을 들으니 기쁩니다. 제가 호스팅 중인 Discourse 인스턴스에 설치할 수 있는지 확인해 보고, 가능하면 피드백을 가지고 돌아오겠습니다. 감사합니다!

6개의 좋아요

여기서 답변을 깜빡했네요. 후속 질문을 남겨주셔서 감사합니다.

Wiki가 community support dev와 같은 다양한 카테고리에 속할 수 있다는 점과, 사용자 주제 관심사에 기반한 데이터를 보여주는 것이 더 좋다는 점을 이해하고 있습니다.

한편, 해당 위키를 문서에 정리해서 보여주는 것(위키 사이드바 링크)은 멋진 아이디어인 것 같습니다.

1개의 좋아요

저희는 디스코urses를 이슈 트래커로 사용하고 있습니다. 더 정확히 말하면, 제가 팀원들에게 디스코urses를 이슈 트래커로 사용하도록 강요하고 있는 거죠 :slight_smile: 그리고 위키, 포럼, 문서화 도구로도요. CDCK 팀이 내부적으로 그들의 업무를 관리하기 위해 몇 가지 흥미로운 플러그인을 사용하여 다른 “비밀” 디스코urses 사이트를 운영할 것 같다는 의심이 듭니다. 아무도…

여기서 이슈 트래커가 아무리 훌륭해도, 커뮤니티는 제가 아는 어떤 것과도 비교할 수 없습니다. 결국 소프트웨어를 개발하는 것은 기술이 아니라 사람입니다. 그리고 그들은 정말 훌륭합니다! :metal:

그리고 문서화 플러그인을 정말 좋아합니다. :heart:

이 모든 칭찬을 드렸으니, 제 PR을 승인해 주실 수 있을까요? :smiley:

5개의 좋아요

그 PR에 대한 Gerhard의 답변을 확인해 보셨나요?

3개의 좋아요

[quote=“Tomas Vavrda, post:15, topic:321764, username:tvavrda”]
CDCK 팀이 내부적으로 업무를 추적하기 위해 몇 가지 흥미로운 플러그인을 사용하는 또 다른 “비밀” Discourse 사이트를 가지고 있다고 의심합니다. 아무도…[/quote]

우리는 내부적으로 사용하는 다른 사이트를 가지고 있으며, 실제로 많은 업무를 그렇게 추적하고 있습니다. 하지만 우리는 비밀스러운 플러그인을 사용하지 않습니다.

대부분은 "할 일"을 위한 카테고리나 now/next/later 우선순위 설정을 위한 표준 태그 세트, 그리고 소유권을 명확히 하기 위한 assign 플러그인 같은 관례를 사용합니다.

이렇게 하면 kanban 테마 컴포넌트도 작동할 수 있지만, 모든 사람이 그 뷰를 사용하는 것은 아닙니다.

꽤 유연한 구조이며, 강하게 의견이 담긴 이슈 트래커는 아니지만, 우리에게 잘 작동합니다.

어떤 때는 더 많은 세부 사항을 공유할 수도 있겠습니다…

6개의 좋아요

아니요! 제 실수입니다. 수정했습니다. 알려주셔서 감사합니다.

3개의 좋아요