# ディスカッションフォーラムのドキュメント

**URL:** https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849
**Category:** Site feedback
**Created:** [2023 年 10 月 3 日午前 7:12 UTC](https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849 "2023-10-03T07:12:44Z")
**Posts on this page:** 10
**Page:** 1

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [2023 年 10 月 3 日午前 7:12 UTC](https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849/1 "2023-10-03T07:12:44Z")

</div>

> [@gilgongo](#):
>
> しかし、ディスカッションフォーラムをドキュメントプラットフォームとして利用することは、明白な理由から理想的ではありません。

もしよろしければ、#Contribute > Site feedback のトピックを作成して、もう少し詳しくご説明いただければ幸いです。👍 私たち自身も、多くのサイトと同様に、カテゴリをナレッジベースとして利用していますが、もしご意見やフィードバックがございましたら、改善策を検討させていただくことを常に歓迎しております。

---

<div class="post-metadata">

### Author: ![gilgongo](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/gilgongo/32/330356_2.png) [@gilgongo](https://meta.discourse.org/u/gilgongo)
#### Post date: [2023 年 10 月 3 日午前 7:30 UTC](https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849/2 "2023-10-03T07:30:08Z")

</div>

ありがとうございます。「議論ベースのドキュメント」は、新しいユーザーにとっては大変な作業になりがちです。なぜなら、投稿を読み、その投稿を更新または修正する議論のスレッドを読む必要があるからです。もちろん、これは私自身の意見ですが、他の人はそう思わないかもしれないことも理解しています 🙂

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [2023 年 10 月 3 日午前 7:44 UTC](https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849/3 "2023-10-03T07:44:46Z")

</div>

ええ、私もそれはあまり好きではありません。🙂 また、長い返信の尾は、それ自体が威圧的に感じられることがよくあります。ここでは（しばしば遅延があることは承知していますが）、その状況を避けるために、関連するすべての情報をOPに移動させるという考えです。また、検索しやすくするために、明確に区切られた議論を別のトピックに分割するようにしています（可能な場合はタグ付けします）。また、一定期間経過後に古い返信をクリアする自動削除タイマーもいくつかあります。まだ作業中ですが、正しい方向に向かっていることを願っています。🙂

---

<div class="post-metadata">

### Author: ![gilgongo](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/gilgongo/32/330356_2.png) [@gilgongo](https://meta.discourse.org/u/gilgongo)
#### Post date: [2023 年 10 月 3 日午前 7:54 UTC](https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849/4 "2023-10-03T07:54:19Z")

</div>

はい。ある程度は混乱を避けられないと思いますが、あなたが努力していることを知っておくのは良いことです（もっとも、後で編集された元の投稿に組み込まれたコメントを削除するようなことまでするかは疑問ですが、それはしばしば主な時間の浪費になります）。

しかし、私の元の指摘は実際にはそれほどのことではありませんでした。あなたがもちろんF/LOSSプロジェクトではないことに、少し遅れて気づいたと思います。そのため、私のような部外者が「助け」を提供しようとすることに感謝しないかもしれません。

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [2023 年 10 月 3 日午前 8:52 UTC](https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849/5 "2023-10-03T08:52:47Z")

</div>

コミュニティによって作成されたドキュメントやアドバイスに感謝します。👍

> [@gilgongo](#):
>
> （ただし、編集されたOPに組み込まれたコメントを削除するほどではないと思いますが、これはしばしば主な時間の無駄です）。

自動削除タイマーはかなり無差別なので、諸刃の剣になり得ます。🙂 しかし、意図は、必要に応じて/有用な履歴を保持するために、ドキュメントの変更提案を別のトピックに切り離すことです。それは、ええと、「有機的」なプロセスなので、そうでない例がいくつか/多く見つかるかもしれません。🙂

ただし、何かを見つけて変更/改善すべきだと思う場合は、かなり迅速に対応します。👍

---

<div class="post-metadata">

### Author: ![Stephen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stephen/32/95011_2.png) [@Stephen](https://meta.discourse.org/u/Stephen)
#### Post date: [2023 年 10 月 3 日午後 3:56 UTC](https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849/6 "2023-10-03T15:56:45Z")

</div>

私が言及していたのはそれではありません。提供したリンクを確認しましたか？

[ドキュメントカテゴリ](https://meta.discourse.org/c/documentation/10)に誘導したのではなく、/docsは[Discourse Docs](https://meta.discourse.org/t/discourse-docs-documentation-management/130172)プラグインによって生成されます。

インターフェースはかなり異なり、典型的なナレッジマネジメントシステムに似ており、検索とフィルタに特化しています。返信は省略され、編集履歴からわかるように、元の投稿に定期的にまとめられています。

---

<div class="post-metadata">

### Author: ![gilgongo](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/gilgongo/32/330356_2.png) [@gilgongo](https://meta.discourse.org/u/gilgongo)
#### Post date: [2023 年 10 月 3 日午後 5:09 UTC](https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849/7 "2023-10-03T17:09:37Z")

</div>

ありがとうございます。ただ、会話の趣旨とは関係ないように思えたので、返答を控えてしまいました。プラグインの存在を知ることができたのは良かったのですが 🙂

---

<div class="post-metadata">

### Author: ![Stephen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stephen/32/95011_2.png) [@Stephen](https://meta.discourse.org/u/Stephen)
#### Post date: [2023 年 10 月 3 日午後 5:15 UTC](https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849/8 "2023-10-03T17:15:34Z")

</div>

> [@gilgongo](#):
>
> それが会話にどう関係するのか分かりません

> [@gilgongo](#):
>
> 適切な形式ではない（または、あなたが示したように発見可能ではない）だけです

ドキュメントが適切な形式ではなく、発見可能ではないというコメントを受けて、メタでドキュメントを異なる形式で提示し、発見可能性を高める機能を含むツールのリンクを共有しました。

郵便配達員の経験から、ここでのアプローチがすぐに馴染まないかもしれないことは理解しています。メタで9年間支援を提供してきた者として、ドキュメントがサポートディスカッションの近くにあることが非常に役立つことを保証できます。

---

<div class="post-metadata">

### Author: ![gilgongo](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/gilgongo/32/330356_2.png) [@gilgongo](https://meta.discourse.org/u/gilgongo)
#### Post date: [2023 年 10 月 3 日午後 5:20 UTC](https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849/9 "2023-10-03T17:20:19Z")

</div>

なるほど、誤解していました。

あなたがやりたいことをするのは全く問題ありません。私は単に、補足的なインストール手順を追加するためにリポジトリにPRを提出することに感謝するかどうかを知りたかっただけです。感謝しないという答えだと理解しました。

それでは、私は失礼します。ご寛容に感謝いたします 🙂

---

<div class="post-metadata">

### Author: ![Lilly](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/lilly/32/575047_2.png) [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [2023 年 10 月 3 日午後 5:27 UTC](https://meta.discourse.org/t/documentation-in-a-discussion-forum/280849/10 "2023-10-03T17:27:48Z")

</div>

> [@gilgongo](#):
>
> ここに「ドキュメント」カテゴリがあり、少なくともその情報の一部が見つかることに気づきました。しかし、議論フォーラムをドキュメントプラットフォームとして使用するのは理想的ではありません。その理由は明白だと思います。

私はその#documentationカテゴリが好きで、しばしば利用しています。それが理想的ではないという明白な理由が見当たらないため、混乱しています。🤷🏻‍♀️

そこには多くの有用な情報があり、そこに貢献を提出することは感謝され、おそらく他の人にも役立つでしょう。
