让 Docs 在论坛上更显眼?

我一直是这个论坛的会员多年,但我从不使用 https://meta.discourse.org/docs,因为我总是忘记它的存在。

我甚至曾经想过,“如果顶部导航栏有一个 Docs 链接就好了……”然后才意识到它已经有了:

image

出于某种原因,我的大脑完全忽略了它。

另外,侧边栏的链接隐藏在“更多”菜单的末尾,我认为(没有数据支持这个想法)很少有人会点击它。

我还想知道,在 Docs 导航按钮旁边放一个图标是否能帮助我的大脑注意到它。

image

那么,把它们放在标题的 Logo 旁边怎么样?也许是两个链接?一个指向 https://meta.discourse.org/docs,另一个指向 https://docs.discourse.org/?

另外,有些事情让我困惑:

  • Docs 是元文档
  • Discourse Docs 是插件。
  • #docs 是与插件相关的标签。
  • 链接 imageimage 指向 Docs
  • #documentation 是一个与 Docs 不直接相关的类别。
  • docs.discourse.org 是 API 文档。

有点令人困惑,对吧?

话虽如此,但最主要的一点是,我总是忘记 Documentation - Discourse Meta 的存在,因此我从不使用它。我最接近的做法是使用搜索,从 #documentation 开始。

7 个赞

作为额外的奖励,您还可以在搜索中使用in:docs过滤器。:+1:

4 个赞

我也是!

我以为这是个玩笑。我最近还在抱怨根本找不到文档。但这不是玩笑,它就在那里,显而易见。

这似乎也属实,除了我前几天找它的时候,以为它不在那里,或者可能我只是觉得它不应该藏得这么深。

我不确定这是用户体验的问题,还是“你可以把马带到水边,但不能强迫它喝水”的情况。

1 个赞

我认为问题的一小部分,也是 @chapoi 过去曾提出过的问题,是这个菜单实际上不应该是一个导航菜单……它是一个筛选菜单,我们添加了几个导航链接(类别和文档)。

Screenshot 2023-05-16 at 12.30.08 PM

将文档放在侧边栏的“社区”部分,与其他导航链接一起(而不是放在抽屉里),可能会更有意义。不过,如果有人不使用侧边栏,这可能会降低其可发现性,所以如果文档链接需要更明显,我们可能还需要在其他地方提及它 :thinking:

5 个赞

我几乎所有的普通手机用户都不使用侧边栏。他们觉得没有什么需要。而且……我其实理解他们。

3 个赞

我认为这是一个“是的,而且……”的情况。

事实上,我们在三个地方链接了文档:

  • 新用户、匿名用户横幅
  • 顶部的过滤器标题
  • 侧边栏

我的建议是,我们将文档移到侧边栏的“fold”上方,这样它就会显示在“Topics”下方。另外,给它加上一个 :open_book: 符号。

另外,在 New to Discourse? Start here! 中添加对它的引用,该链接被置顶,我们希望用户在加入 meta 时阅读它。

1 个赞

我刚在菜单的第一个部分“主题”下添加了“文档”,看看效果如何。我很喜欢!

但是,我不知道如何删除自动添加到此列表底部的另一个链接。可能需要更改插件以停止自动显示它或使其可配置。

3 个赞

抱歉三连发……我再次将其从侧边栏中移除,以防止文档重复列出。我们正在努力修复允许自定义插件侧边栏项的问题,这将有助于我们解决此问题。

1 个赞