[有料] GithubからDiscourseへのコンテンツ同期(リポジトリファイル→トピック)

何を依頼したいですか?

  • 特定のリポジトリ内のファイルからコンテンツを直接トピックに公開する Discourse 用プラグインの構築
    • このタイプのプラグインの想定ユースケースは、GitHub 内でコンテンツを管理する(バージョン管理、イシュー、プルリクエストなど)一方で、常に特定のトピックと同期を保つことです
    • 具体的なユースケースには、ハンドブック、ナレッジベース、アイデアのリポジトリなどが含まれます
      • 特に当社の内部ユースケースとしては、Discourse をナレッジのハブとして利用していますが、コンテンツの更新や編集に対してよりきめ細やかな制御を求めたいと考えており、そのために Git フローを活用したいというものです
  • 追加の注意点
    • .md ファイルのみ対応すれば十分です
    • オープンソース化を希望しています(初期開発費用は当社が負担します)

いつまでに必要ですか?

  • 急ぎではありませんが、今後数ヶ月以内を想定しています

このタスクに提供できる予算(米ドル)はどのくらいですか?

  • スコープがまだ完全には明確でないため、まずそれを決定する必要があります
  • 入札を歓迎します
「いいね!」 4

この点において、Discourse に何が不足しているのでしょうか?Discourse を改善して、GitHub を一切使わずにニーズを満たせるようにすることは可能でしょうか?

プルリクエストについて言及されていますが、おそらく必要なのは、変更を提案し、それを第三者がレビューして承認してから変更を確定する機能ではないでしょうか。Discourse らしい方法としては、レビューを依頼するために投稿に返信したり、変更後に誰かに割り当てたりすることが考えられます。トピックのタイマーを設定して返信を自動削除することで、トピックが小さな返信で埋もれるのを防いだという成功例もあります。

もう一つのアイデアとして、Policy プラグインを利用する方法があります。トピックが変更されたことをグループに通知し、変更を読み同意したことを確認させることができます。

以上を踏まえても、これは非常に素晴らしいアイデアだと思いますし、実装されることを願っています。Meta であっても役立つ場面があるでしょう。ここでは GitHub リポジトリに関するトピックが多数ありますが、それらのリポジトリの readme.md ファイルの更新を OP(最初の投稿)に表示できれば、二箇所でメンテナンスする必要がなくなります。

Discourse for Teams においても有用な機能となるでしょう。GitHub を頻繁に利用するチームでも、Teams を「唯一の情報源(single source of truth)」として参照できるため、全員が常に GitHub にログインする必要がなくなります。おそらく、Code Review プラグインの一部、あるいはそれと併用する機能として実装されるかもしれません。

「いいね!」 2

ここで最大の課題はブランチ機能です。ここでの根本的な動機は、何かをブランチして改善・レビューし、その後マージできるメカニズムが存在することです。同様に、レビュアーがブランチ自体に対してより小規模な変更を加えることで、変更に対するよりきめ細かい制御を可能にするプロセスも提供できます。

そうなれば素晴らしいのですが、不足している要素は少し複雑です。

  • ブランチ機能
  • クリック一つで変更をマージする機能

ブランチ機能へのこだわりが私ほど強くない人にとっては、これは素晴らしいハックですね。

これは多くの面で非常に役立つと感じます。もし適切な開発者を見つけたら、ぜひ一緒に協力したいです。このツールが将来的に「公式」プラグインになることを願っています(叶えば良いのですが)。

「いいね!」 2

中央のユースケースが .md ファイルと共通言語である場合でも、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.