# Call to action: Send us your "see also" suggestions **URL:** \ **Category:** Project Discussions\ **Tags:** documentation, collections\ **Created:** [February 27, 2024, 5:09pm UTC](https://forum.ansible.com/t/call-to-action-send-us-your-see-also-suggestions/4093 "2024-02-27T17:09:03Z")\ **Posts on this page:** 6\ **Page:** 1
**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\ **Post date:** [February 27, 2024, 5:09pm UTC](https://forum.ansible.com/t/call-to-action-send-us-your-see-also-suggestions/4093/1 "2024-02-27T17:09:03Z")
Hi! [Configmgmtcamp 2024](https://cfgmgmtcamp.eu/ghent2024/) was a blast. There were a lot of great sessions and sharing of ideas. One piece of feedback that came up was to expand the use of the “See also” section in module documentation. If you’re not familiar, the “See also” section points out modules that have similar functionality but for different use cases or, sometimes, for different platforms. It is a convenient way to disambiguate similar modules but also to group related modules that build and expand on each other’s functionality. It can often be the case that you start using one module with a certain goal. However the module that you are using is only related to that goal but not specifically intended for the purpose and is not the best thing to use. You can find an example of the “See also” section in the [ansible.builtin.copy](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/copy_module.html#see-also) module documentation. So what can I do, you ask? Do you have any examples of modules in collections that could benefit from a “See also” section? Let us know! You can reply to this thread with any ideas for pointing out good candidates for a “See also” section in module docs. We can then try and work with the collection owners to update their documentation. ---
**Author:** ![chris](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/chris/32/293_2.png) [@chris](https://forum.ansible.com/u/chris)\ **Post date:** [February 28, 2024, 11:00am UTC](https://forum.ansible.com/t/call-to-action-send-us-your-see-also-suggestions/4093/2 "2024-02-28T11:00:01Z")
Great idea, I’d also like to see more examples adding to pages perhaps another thread for that would make sense? ## INI / CONF The `.ini` / `.conf` file lookup, fliters and modules could be linked: - [community.general.ini\_file module](https://docs.ansible.com/ansible/latest/collections/community/general/ini_file_module.html) - [ansible.builtin.ini lookup](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/ini_lookup.html) - [community.general.to\_ini filter](https://docs.ansible.com/ansible/latest/collections/community/general/to_ini_filter.html) - [community.general.from\_ini filter](https://docs.ansible.com/ansible/latest/collections/community/general/from_ini_filter.html) And also the JC INI parsers that can be used with [the JC filter](https://docs.ansible.com/ansible/latest/collections/community/general/jc_filter.html): - [jc.parsers.ini](https://kellyjonbrazil.github.io/jc/docs/parsers/ini) - [jc.parsers.ini\_dup](https://kellyjonbrazil.github.io/jc/docs/parsers/ini_dup) And perhaps the [Wikipedia INI page](https://en.wikipedia.org/wiki/INI_file) and a list of some key applications that use INI format could be added, eg: - MariaDB / MySQL - PHP - Systemd Perhaps a whole page dedicated to `.ini` / `.conf` files with examples would make sense? 🤷 # JMESPath The [community.general.json\_query filter](https://docs.ansible.com/ansible/latest/collections/community/general/json_query_filter.html) page could link to [Selecting JSON data: JSON queries](https://docs.ansible.com/ansible/latest/collections/community/general/docsite/filter_guide_selecting_json_data.html) and that could link to the [`jp` cli project](https://github.com/jmespath/jp) and also the [JMESPath Terminal](https://github.com/jmespath-community/jmespath.terminal) project. ---
**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\ **Post date:** [March 5, 2024, 5:04pm UTC](https://forum.ansible.com/t/call-to-action-send-us-your-see-also-suggestions/4093/3 "2024-03-05T17:04:40Z")
Hey @chris Thanks for the suggestions! We talked about this briefly at the docs working group today on Matrix. You can find the minutes here: [Meeting Log | Ansible Docs | 2024-03-05 16:01:43](http://forum.ansible.com/t/meeting-log-ansible-docs-2024-03-05-1643/4223/1) This provoked some interesting conversation because your suggestion expands the “see also” section beyond Ansible documentation to more general technical resources, like the Wikipedia INI page. There might even be a blog post or two in there! Over the next week or so I’m planning to break your suggestions into GitHub issues so we can track the updates and hopefully get some community contributors to participate in applying them. However I’m holding off a bit longer until the next edition of the Bullhorn. I included this forum post in an update and am hopeful we might get some more excellent suggestions. So stay tuned! ---
**Author:** ![briantist](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/briantist/32/130_2.png) [@briantist](https://forum.ansible.com/u/briantist)\ **Post date:** [March 7, 2024, 3:18pm UTC](https://forum.ansible.com/t/call-to-action-send-us-your-see-also-suggestions/4093/4 "2024-03-07T15:18:15Z")
I just want to say that I _love_ the `seealso` section in docs and use it a lot in [the public collection I maintain](https://docs.ansible.com/ansible/devel/collections/community/hashi_vault/vault_kv2_write_module.html#see-also) and also in the private internal collections I work on. ---
**Author:** ![briantist](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/briantist/32/130_2.png) [@briantist](https://forum.ansible.com/u/briantist)\ **Post date:** [March 7, 2024, 3:29pm UTC](https://forum.ansible.com/t/call-to-action-send-us-your-see-also-suggestions/4093/5 "2024-03-07T15:29:37Z")
> [@oranod](#): > > This provoked some interesting conversation because your suggestion expands the “see also” section beyond Ansible documentation to more general technical resources I also use this. It can be direct web links, but it’s also a good thing to keep in mind that one of the entry types is for general RST references. Since we use intersphinx, and the ansible collection docs specify a few other sphinx sites, we can link to those with direct references, for example to python or jinja documentation (this is also how collection docs can link to the main docsite pages without using hyperlinks). To give an example, in one of my internal collections, I have this entry that links to Jinja2 docs (alongside an entry to the main ansible docs): ```yaml seealso: - plugin: ansible.builtin.version plugin_type: test - ref: builtin-filters description: See the Jinja2 C(select) built-in filter. ``` ---
**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\ **Post date:** [March 13, 2024, 5:22pm UTC](https://forum.ansible.com/t/call-to-action-send-us-your-see-also-suggestions/4093/6 "2024-03-13T17:22:45Z")
Thanks for chiming in @briantist it’s always nice to hear from you and see some examples! @chris Thanks again for providing those suggestions. I’ve opened an issue in the docs repo here: [Link "see also" sections as recommended in the forum · Issue #1200 · ansible/ansible-documentation · GitHub](https://github.com/ansible/ansible-documentation/issues/1200) I’ll give some of the regular docs contributors a chance to handle the issue but will send the PRs myself if nobody else takes it on. If it’s OK with you I’ll give you the “co-authored by” attribution in the commits too. Cheers!