首页应该用于哪些文档类别?

当您点击 Documentation > Site Management 时,我想知道它是否应该将您带到索引,而不是最新主题

或者它应该将您带到您指定的其他“概览”主题?

我们一直在类别描述中直接链接到索引,以使其更易于发现:

相关讨论

或者保持原样?鉴于索引已经在侧边栏中,这可能有些多余,但当前的设计在两方面让我感觉有点不对劲:

  • 索引本身可能难以找到
  • 与在给定主题中浏览文档的方式相比,最新主题列表感觉有点令人迷失方向
4 个赞

我想知道索引是否能更好地引导用户进入文档。我看到的问题是,索引页面和侧边栏都不能方便地扫描和导航文档主题:

不确定是否有明显的解决方案?现有的文档平台有一些更好的侧边栏布局模式。但是,在不增加实际主题组织工作量的情况下,它们能改善我们的情况吗?它们可能对整个社区维基(community wiki)效果不佳。

也许一个右侧边栏,采用更像目录(table of content)的布局,而不是当前狭窄的左侧边栏,效果会更好?

3 个赞

我也一直在思考这个问题,虽然这与 meta.discourse.org 无关,但它是 docs categories 插件的一个普遍需求。在许多情况下,直接跳转到索引页要好得多,我认为这能让用户更清楚地理解侧边栏的内容,避免他们进入某个分类后,直到打开话题才注意到侧边栏已发生变化。

如果在插件中提供一个选项,允许针对特定分类启用该功能,那就太好了。这样,在遇到像这里提到的超长列表时,可以禁用该功能;而在其他情况下,则可以启用它。

我今天进一步研究了这个问题——我在考虑是否要提交一个拉取请求,为插件添加一个设置。启用后,该设置将强制将指向分类的直接链接重定向到该分类的文档索引页面。在查看该插件的现有工作时,我发现了一个正在进行中的更大规模的功能重构:FEATURE: Add visual doc category index editor by megothss · Pull Request #87 · discourse/discourse-doc-categories · GitHub

看来现在正是添加这种可选功能的好时机,以便使用文档索引作为分类列表。同时,这可能会与 @sam 正在开发中的“简单模式”产生冲突。Sam,你认为我上面描述的选项是否适合融入你对简单模式的工作,或者适合 PR 中正在进行的更大规模工作,以提供更多构建索引的选项?如果能选择你正在开发的简化列布局,或者直接使用索引主题,那将非常棒。甚至理想情况下,帖子的内容可以显示在完整、正常或简单的分类列表上方。

1 个赞