Docs: Organize by task, then type of content
We have user feedback that shows people have trouble finding the content they need.
Right now we have all content in one place, regardless of the audience or the type of content.
To make things easier to find, we could group the content at a high-level, and then further define it by content type.
Here is a mockup/very rough idea of what it would look like: https://docs.google.com/presentation/d/1FQFR-62NCVkxGLL6hYBOvPVDZNxHiMO_WNUS9_tHp4Q/edit?usp=sharing
For example:
In this example, the home page would have the top-level buckets with the other buckets listed underneath. This layout would give us room to grow and add more content types. (We sometimes get requests for new content types, and we put them into the pile with everything else.)
We could also separate the content by URL. For example:
- docs.gitlab.com/install
- docs.gitlab.com/admin
- docs.gitlab.com/user
Each of these URLs can have its own nav. That way we'd have a bit less nesting.
This is just an idea and we could do some UX testing to see if it works better than what we have now.
However it is similar to the IA used by other companies:
- AWS EC2 content
- Google Cloud
-
GitHub - In the left nav, select
Pull requests
- Splunk