# Make Docs more visible on the forum?

**URL:** https://meta.discourse.org/t/make-docs-more-visible-on-the-forum/265169
**Category:** Site feedback
**Created:** [May 16, 2023, 10:50am UTC](https://meta.discourse.org/t/make-docs-more-visible-on-the-forum/265169 "2023-05-16T10:50:46Z")
**Posts on this page:** 8
**Page:** 1

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [May 16, 2023, 10:50am UTC](https://meta.discourse.org/t/make-docs-more-visible-on-the-forum/265169/1 "2023-05-16T10:50:47Z")

</div>

I’ve been a member of this forum for years, but I never use [Documentation - Discourse Meta](https://meta.discourse.org/docs) because I forget it exists.

I even once thought, “it would be cool if there was a Docs link in the top navigation…” and then realized that there already is one:

![image](https://global.discourse-cdn.com/meta/original/4X/8/9/e/89e5b6f6caee7abaf53d40a422712c01892474d5.png)

For some reason, my brain completely ignored it.

Also, the sidebar link is hidden at the end of the More menu, which I think (no data to back up this thought) very few people click.

I also wondered if some icon next to the Docs nav button would help my brain notice it.

![image](https://global.discourse-cdn.com/meta/original/4X/c/1/3/c139743b034d0c9c3cf4d0456b779dc0b1004bce.png)

And what about putting it next to the logo in the header? Maybe two links? One for [Documentation - Discourse Meta](https://meta.discourse.org/docs), one for [https://docs.discourse.org/](https://docs.discourse.org/)?

 ![image](https://global.discourse-cdn.com/meta/original/4X/6/9/7/697d0b7be9fcccdaf6d598b45f4de361059a3b72.png)

Also, something bugs me:

- Docs is meta documentation

- Discourse Docs is the plugin.

- `#docs` is the tag related to the plugin.

- The links ![image](https://global.discourse-cdn.com/meta/original/4X/e/c/5/ec5699b7bfafe10b413fc13cec641f0a59d6dfa3.png) & ![image](https://global.discourse-cdn.com/meta/original/4X/6/7/f/67f1740228d708dc11c52ff87e66d4cad488f745.png) lead to Docs

- `#documentation` is a category not directly related to Docs.

- `docs.discourse.org` is the API documentation.

A bit confusing, right?

That said, the main point is that I always forgot that [Documentation - Discourse Meta](https://meta.discourse.org/docs) exists, and because of this, I never use it. The closest I do is using the search, starting with `#documentation`.

---

<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: [May 16, 2023, 10:54am UTC](https://meta.discourse.org/t/make-docs-more-visible-on-the-forum/265169/2 "2023-05-16T10:54:07Z")

</div>

> [@Canapin](#):
>
> That said, the main point is that I always forgot that [Docs - Discourse Meta](https://meta.discourse.org/docs) exists, and because of this, I never use it. The closest I do is using the search, starting with `#documentation`.

Just as an added bonus, you can also use the `in:docs` filter in your searching too. 👍

---

<div class="post-metadata">

### Author: ![pfaffman](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pfaffman/32/120154_2.png) [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [May 16, 2023, 3:15pm UTC](https://meta.discourse.org/t/make-docs-more-visible-on-the-forum/265169/3 "2023-05-16T15:15:52Z")

</div>

> [@Canapin](#):
>
> I’ve been a member of this forum for years, but I never use [Docs - Discourse Meta](https://meta.discourse.org/docs) because I forget it exists.

Me too!

> [@Canapin](#):
>
> I even once thought, “it would be cool if there was a Docs link in the top navigation…” and then realized that there already is one:

I assumed that this was a joke. I recently lamented that there was NO WAY TO FIND THE DOCS. But, this is no joke. It’s right there. Plain as day.

> [@Canapin](#):
>
> Also, the sidebar link is hidden at the end of the More menu, which I think (no data to back up this thought) very few people click.

This also seems true, except I looked for it the other day and thought I couldn’t find it there, or maybe I just thought it needed not to be so hidden.

I’m not sure if this is a case of UX or of you can lead a horse to water.

---

<div class="post-metadata">

### Author: ![awesomerobot](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/awesomerobot/32/142900_2.png) [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [May 16, 2023, 4:34pm UTC](https://meta.discourse.org/t/make-docs-more-visible-on-the-forum/265169/4 "2023-05-16T16:34:37Z")

</div>

I think a small part of the problem, which is something that @chapoi brought up at some point in the past, is that this menu isn’t really _supposed_ to be a navigation menu… it’s a filter menu that we’ve added a couple navigation links to (categories and docs).

![Screenshot 2023-05-16 at 12.30.08 PM](https://global.discourse-cdn.com/meta/optimized/4X/b/5/d/b5d8f0b44dfc5fdc842c3704fcb6317e747cef23_2_690x52.png)

It would probably make more sense for Docs to live in the “community” section of the sidebar alongside other nav links (not in the drawer). This might make it less discoverable if someone doesn’t use the sidebar though, so if the docs link needs to be more obvious we might also need to call it out somewhere else 🤔

---

<div class="post-metadata">

### Author: ![Jagster](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jagster/32/192154_2.png) [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [May 16, 2023, 4:45pm UTC](https://meta.discourse.org/t/make-docs-more-visible-on-the-forum/265169/5 "2023-05-16T16:45:54Z")

</div>

> [@awesomerobot](#):
>
> if someone doesn’t use the sidebar

Practically none of my ordinary mobile users use the sidebar. There isn’t anything they feel to need. And… actually I understand them.

---

<div class="post-metadata">

### Author: ![tobiaseigen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tobiaseigen/32/539204_2.png) [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [July 24, 2023, 4:19pm UTC](https://meta.discourse.org/t/make-docs-more-visible-on-the-forum/265169/6 "2023-07-24T16:19:52Z")

</div>

I think this is a case for “yes, and..”

We have the docs linked in three places, in fact:

- banner for new, anon users
- filter header at the top
- sidebar

My suggestion would be we move docs to “above the fold” in the sidebar, so it shows under Topics. Also to give it some kind of book 📖 glyph.

Also to add reference to it in [New to Discourse? Start here!](https://meta.discourse.org/t/welcome-to-meta-discourse-org/1?silent=true) which is pinned and we expect people to read when they join meta.

 ![Screenshot 2023-07-24 at 9.16.41 AM](https://global.discourse-cdn.com/meta/original/4X/c/5/0/c50d21eab43e85f39b3a213c074c928093b83f66.png)

---

<div class="post-metadata">

### Author: ![tobiaseigen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tobiaseigen/32/539204_2.png) [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [July 24, 2023, 4:36pm UTC](https://meta.discourse.org/t/make-docs-more-visible-on-the-forum/265169/7 "2023-07-24T16:36:33Z")

</div>

I just added Docs to the first part of the menu, under Topics, to see what it would look like. I like it!

However, I don’t see how to remove the other link which is added automatically to the bottom of this list. Would likely need a change in the plugin to stop showing it automatically or make it configurable.

---

<div class="post-metadata">

### Author: ![tobiaseigen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tobiaseigen/32/539204_2.png) [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [July 24, 2023, 7:01pm UTC](https://meta.discourse.org/t/make-docs-more-visible-on-the-forum/265169/9 "2023-07-24T19:01:18Z")

</div>

With apologies for the triple post.. I removed it again from the sidebar to prevent the double listing of docs. We are working on a fix to allow customizing sidebar items for plugins which will help us here.
