-
Notifications
You must be signed in to change notification settings - Fork 19
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs.ansible.com: one-click module-category link on the module pages #147
Comments
@gitqlt thanks for writing up this proposal. Currently each page has two breadcrumb links: one to itself (on the page you reference, that's the "Including and Importing" link) and the other ("Docs") to the main index page for the Ansible Core documentation. I've added this to the agenda for the November 6 Documentation Working Group meeting. |
👍 |
The module pages also have another problem: They don't collapse the navigation on the left side. So, even if you are on a modules page, you have to collapse the menu to get to the categories. For me, the modules reference is the main reason why I visit the docs. I just want to check quickly modules/argument names. |
👍 |
After starting with the collections, breadcrumb links are still missing on the documentation pages of the modules. Most collections, including With the General Community, you have a two-click hack. The modules here have a link to the Galaxy where you find the Ansible Docs site. Again, the breadcrumb links would be better. === |
@gitqlt please review ansible-community/antsibull#240 |
Proposal:
Author: gitqlt <@gitqlt> IRC: n/a
Date: 2018-10-21
Motivation
Easier navigation with one-click module-category link on the module pages.
Problems
The positioning header on the top of the module pages shows only two (clickable) levels. Eg:
However, the module category link (here: Commands modules) is missing. To see all the similar modules together makes it easier to learn/differentiate the modules' functionality, so the module category should be accessible with one-click from the module description page.
Solution proposal
Include the
module index
,module category
links as well. Eg:Dependencies (optional)
Testing (optional)
Documentation (optional)
Anything else?
The problem is not just with the modules. For example, the positioning header of page https://docs.ansible.com/ansible/2.7/user_guide/playbooks_reuse_includes.html
currently shows
but should be constructed from the links:
The text was updated successfully, but these errors were encountered: