[유료] GitHub에서 Discourse로 콘텐츠 동기화 (리포지토리 파일 → 토픽)

무엇을 해 주길 바라시나요?

  • 특정 리포지토리의 파일에 있는 콘텐츠를 해당 토픽에 직접 게시하는 Discourse 플러그인을 구축하는 것
    • 이 유형의 플러그인의 의도된 사용 사례는 콘텐츠 관리를 먼저 Github에서 수행하는 것입니다(버전 관리, 이슈, 풀 리퀘스트 등). 하지만 헤드(head)는 항상 특정 토픽과 동기화되어 있어야 합니다.
    • 사용 사례에는 핸드북, 지식 베이스, 아이디어 리포지토리 등이 포함됩니다.
      • 특히 내부 사용 사례는 Discourse를 지식 허브로 사용하고 있지만, 콘텐츠 업데이트 및 편집에 대해 더 세밀한 제어가 필요하기 때문에 Git 플로우가 도입됩니다.
  • 몇 가지 추가 참고 사항
    • .md 파일로만 작동하면 됩니다.
    • 이 프로젝트가 오픈소스로 공개되기를 희망합니다(초기 개발 비용은 저희가 부담합니다).

언제까지 완료되길 바라시나요?

  • 시급한 일정은 아니지만, 향후 몇 달 안에 완료되기를 바랍니다.

이 작업에 제공할 수 있는 예산(USD)은 얼마인가요?

  • 범위가 완전히 명확하지 않아 먼저 범위를 결정해야 합니다.
  • 입찰에 열려 있습니다.
4개의 좋아요

이러한 측면에서 Discourse에 무엇이 부족한가요? GitHub를 전혀 사용하지 않아도 될 정도로 Discourse를 개선할 수 있을까요?

풀 리퀘스트(Pull Request)를 언급하셨으므로, 변경 사항을 요청한 후 다른 사람이 검토하고 승인해야 비로소 변경이 확정되는 기능이 필요하다는 뜻일까요? 아마도 Discourse의 방식으로는 변경 사항을 만든 후 검토를 요청하기 위해 게시물에 답글을 달거나, 누군가에게 할당하는 방식으로 이를 구현할 수 있을 것 같습니다. 저는 토픽 타이머를 설정하여 답글을 자동으로 삭제함으로써 토픽이 수많은 짧은 답글로 인해 지저분해지는 것을 방지하는 데 어느 정도 성공적인 경험을 했습니다.

또 다른 아이디어로는 정책(Policy) 플러그인을 사용하는 것이 있습니다. 그룹이 토픽이 변경되었음을 통보받고, 변경 사항을 읽었으며 동의한다는 것을 확인하도록 요청받을 수 있습니다.

그럼에도 불구하고, 이는 꽤 훌륭한 아이디어라고 생각하며 구현되는 모습을 보고 싶습니다. 메타(Meta) 게시판에서도 유용할 수 있다고 봅니다. 여기에는 GitHub 저장소에 관한 토픽이 많으며, 두 곳에서 유지보수하지 않아도 되도록 저장소의 readme.md 파일 업데이트가 원본 게시물(OP)에 반영되는 것을 볼 수 있다면 좋겠습니다.

Discourse for Teams의 경우에도 유용한 기능이 될 수 있습니다. GitHub를 많이 사용하는 팀들이 GitHub에 계속 로그인하지 않아도 Teams를 참조를 위한 "단일 진실의 원천(Single Source of Truth)"으로 사용할 수 있도록 하기 때문입니다. 아마도 코드 리뷰(Code Review) 플러그인의 일부이거나 동반 기능으로 포함될 수 있을 것입니다.

2개의 좋아요

가장 큰 부분은 브랜치(branching)입니다. 여기의 핵심 동기는 실제로는 어떤 것이 분기(branch)되고, 개선되고, 검토된 후 병합(merge)될 수 있는 메커니즘이 있다는 것입니다. 유사하게, 이는 검토자가 브랜치 자체에 대해 더 세밀한 변경 사항을 가하는 유사한 과정을 거칠 수 있게 하여 변경 사항에 대해 더 정밀한 제어권을 부여합니다.

그렇기를 바라고 있지만, 빠져 있는 부분들은 다소 자명하지(non-trivial) 않습니다:

  • 브랜치(Branching)
  • 원클릭 병합(One-click merge)

제 경우처럼 브랜치 측면에 대해 그렇게 중요하게 생각하지 않는 사람들에게는 훌륭한 해킹(hack)입니다.

이것이 여러 면에서 매우 도움이 될 수 있을 것 같습니다. 이 일을 위해 적합한 사람을 고용하게 되면, 조금 협력하고 싶습니다. 어쩌면 이 도구가 결국 “공식” 플러그인으로 자리 잡을 수 있기를 바랍니다! (바랄 뿐이지만요).

2개의 좋아요

핵심 사용 사례가 .md 파일과 공통 언어라면, Discourse가 여전히 큰 이점이 있다고 생각합니다. Discourse는 대화형이며 사람들이 평이한 언어로 실제로 서로 소통할 수 있도록 지원하기 때문입니다. 말씀하신 대로, 지식에 관한 대화는 일반적으로 Discourse에서 이루어지는 것이 좋습니다. 따라서 대부분의 내용을 Discourse에 그대로 유지하는 방법을 살펴볼 가치가 있다고 생각합니다. 그렇지하면 주목도와 집중력이 주된 플랫폼에서 멀어지게 될 수 있습니다.

다음과 같은 구성을 상상해 볼 수 있습니다:

  • Readme.md를 Discourse의 위키 주제로 설정하고 GitHub와 동기화
  • 해당 Readme에 대한 토론은 Discourse의 후속 게시물로 진행하며, 정기적으로 삭제 (meta의 현재 구성과 유사하게)
  • 저장소 내 추가 파일과 폴더는 GitHub에서 브랜치를 사용하여 관리. 현재 저장소 구조를 Discourse와 동기화하여, 위키 게시물에 목차처럼 표시되도록 함
2개의 좋아요

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.