ドキュメントカテゴリのインデックス管理にもっと良い方法は?

これは、私の意見では、元のDocsプラグインからの後退です。

「いいね!」 1

私はここで強く反対します。これは、ドキュメントの外観に関してはるかに多くの柔軟性を提供します。さらに、これにより他のカテゴリのページや外部リンクにリンクすることも可能になります。

「いいね!」 1

しかし、文書が数千件もあり、頻繁に追加されているため、これは非常に手作業のタスクになります。

「いいね!」 2

ええ、Discourseで1000ページのドキュメントを管理できるかどうかはわかりません。より特化したドキュメントソリューションがあるにもかかわらず、それでもできると思います。Gitなしで1000ページは…痛みを伴うでしょうね :stuck_out_tongue:

なぜうまくいかないのですか?元のドキュメントでは非常にうまく機能しています。たとえば、「ライブラリ」カテゴリには、投稿テキストに加えて1つ以上のPDFまたはその他の添付ファイルが含まれるトピックがあります。各トピックには適用可能なタグも付けられているため、検索とタグフィルタリングで物事を見つけるのは非常に簡単です。

おそらくユースケースの問題でしょう。Discourse を早い段階からドキュメントとして使用した結果、それに慣れていくのかもしれませんが、私の分野(技術文書/ユーザー文書)では、いずれにしても手動でのインデックス作成が必要になります。

メンテナーにとっては、投稿を検索して見つけるのは非常に簡単だとわかりました。

しかし、製品に詳しくない、あるいはトピックに慣れていないユーザーの視点から見ると、何を検索すればよいかわからない可能性があります。その場合、私の経験では、構造化することが非常に理にかなっています。そうしないと、ユーザーはドキュメントの迷路の中で迷子になってしまいます。これはご自身でテストできます。ユーザーが読むであろうと思われる、さまざまなタグの中のランダムなドキュメントを 5 ~ 10 個考えてみてください。次に、サイトをクリックするだけでそれらを見つけようとしてみてください。自分で見つけるのに苦労した場合、ユーザーエクスペリエンスがどうなるか想像できるでしょう。

「いいね!」 2

フィルタリングを使えば、簡単に物事を見つけることができます。例えば、Glastar航空機モデルのエンジン取り付け手順を探したいとします。正確に何を探せばいいのか分からないかもしれませんが、概念は検索やフィルタリングが容易です。

古いドキュメントでは、ライブラリカテゴリに入力したものはすべて自動的にドキュメントに追加されていました。個別のインデックスを手動で維持する必要はなく、それが私の異議を唱える点です。

「いいね!」 1

現在のデザインが理想的ではないことには同意します。

柔軟性が必要だったため、それを実現するために設計上の負債を抱えました。それが、Discourse Doc Categories を依然として experimental と見なしている主な理由です。

いつかより良いものを設計・構築するつもりですが、現在は優先事項ではありません。

「いいね!」 5

多くのサイトが採用し、広範囲に実装した元のプラグインが、新しいものへの実用的な橋渡しを提供していないにもかかわらず、end-of-life とマークされていることが問題だと思います。

新しいプラグインを使用してサイトに KM を実装したばかりなので、その経験はまだ記憶に新しいです。ドキュメントビューで何かを見るためにインデックストピックをキュレートしなければならないのは、非常に洗練されていないように感じます。古いプラグインの実装は比較的シームレスで、適切なタグ分類が存在すれば十分でした。

新しいニーズが Discourse Doc Categories の作成を推進したことは理解できますが、あなた自身の言葉によれば、私たちは現在のニーズを満たさない experimental プラグインと、有限の寿命を持つ古いプラグインの間に挟まれています。

「いいね!」 7

スティーブンには完全に同意します。

なぜこれがオリジナルのプラグインの進化ではなく、完全に新しいプラグインとしてアプローチされたのか疑問に思います。ソフトウェアの革命は強力になり得ますが、迅速かつ断固として行われた場合に最も効果を発揮します。

「いいね!」 3

実際、ドキュメント管理のためにDocsプラグインを使用しているわけではありません。必要なのは、複数のカテゴリと複数のタグでトピックを一度にフィルタリングできるシンプルなUIだけで、すべて同じページに表示されるものです。

デフォルトのDiscourseインターフェースでは高度な検索を経由する必要があり、これは隠れすぎている上に、著者や日付など、不要なフィルタが多く含まれています。もっと焦点を絞った直接的な体験を求めています。

古いDocsプラグインは、このマルチカテゴリ、マルチタグフィルタリングを実現するのに役立ちますが、まだ1つの制限があります。
親カテゴリを選択すると、その親の直下にあるトピックのみが表示され、サブカテゴリのトピックは含まれません。
対照的に、デフォルトのカテゴリビューには、親カテゴリとサブカテゴリの両方のトピックが表示されます。

だからこそ、理想的ではないものの、このプラグインをまだ使用しています。
これに関連する以前のリクエストはこちらです: Multi menu select Group tags

議論や改善に時間を割いてくださった皆様、改めて感謝いたします。皆様のサポートと洞察に深く感謝いたします。

「いいね!」 2