# UI improvement request: not display doc\_fragments and module\_utils directories content on the Documentation tab of a collection **URL:** \ **Category:** Project Discussions\ **Tags:** galaxy-ng\ **Created:** [August 5, 2024, 8:30am UTC](https://forum.ansible.com/t/ui-improvement-request-not-display-doc-fragments-and-module-utils-directories-content-on-the-documentation-tab-of-a-collection/7628 "2024-08-05T08:30:27Z")\ **Posts on this page:** 8\ **Page:** 1
**Author:** ![Andersson007](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/andersson007/32/89_2.png) [@Andersson007](https://forum.ansible.com/u/Andersson007)\ **Post date:** [August 5, 2024, 8:30am UTC](https://forum.ansible.com/t/ui-improvement-request-not-display-doc-fragments-and-module-utils-directories-content-on-the-documentation-tab-of-a-collection/7628/1 "2024-08-05T08:30:27Z")
Hello, **UPDATE:** the original proposal was about excluding module\_utils and doc\_fragments content but during the discussion i realized that the true thing that confused me was displaying empty pages on the Documentation, so I agree with the folks the the Content tab should display everything but **the Documentation tab should not display any undocumented entities.** ![Screenshot from 2024-08-06 07-39-52](https://us1.discourse-cdn.com/ansible/original/2X/f/fcf8e43828de90d626f5746960099aecdfc15153.png) ### The original irrelevant proposal for the context Currently the content of `plugins/module_utils` and `plugins/doc_fragments` dirs are displayed under the content tab of [Galaxy NG UI](https://galaxy.ansible.com/ui/repo/published/community/clickhouse/content/): ![Screenshot from 2024-08-05 10-16-33](https://us1.discourse-cdn.com/ansible/original/2X/6/605743f53bf0b46b54688330f932166ef0ab320d.png) - plugins/module\_utils contains Python code used by the modules/plugins - plugins/doc\_fragments contains documentation shared by several or all plugins/modules like common arguments, notes, requirements, etc. so they are automatically included and present in corresponding modules/plugins doc pages there As i think it brings no value to Galaxy NG users but rather confusion, i suggest excluding them and their content from the UI. Thanks ---
**Author:** ![flowerysong](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/flowerysong/32/2305_2.png) [@flowerysong](https://forum.ansible.com/u/flowerysong)\ **Post date:** [August 5, 2024, 3:12pm UTC](https://forum.ansible.com/t/ui-improvement-request-not-display-doc-fragments-and-module-utils-directories-content-on-the-documentation-tab-of-a-collection/7628/2 "2024-08-05T15:12:10Z")
-1. It’s part of the content of the collection and can be reused by other collections (e.g. someone might be trying to figure out which version of `amazon.aws` added a doc fragment that they’re extending in a custom AWS plugin); it’s also possible for a collection to exist solely for the purpose of providing shared `module_utils`and have no modules of its own. ---
**Author:** ![Denney-tech](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/denney-tech/32/1556_2.png) [@Denney-tech](https://forum.ansible.com/u/Denney-tech)\ **Post date:** [August 5, 2024, 6:40pm UTC](https://forum.ansible.com/t/ui-improvement-request-not-display-doc-fragments-and-module-utils-directories-content-on-the-documentation-tab-of-a-collection/7628/3 "2024-08-05T18:40:30Z")
I’m with @flowerysong on this one. If anything, I would prefer the UI to organize the “Documentation” page by the same content types as the “Contents” page. That would make it less confusing, even if there is no documentation being rendered. ---
**Author:** ![felixfontein](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/felixfontein/32/7530_2.png) [@felixfontein](https://forum.ansible.com/u/felixfontein)\ **Post date:** [August 5, 2024, 8:33pm UTC](https://forum.ansible.com/t/ui-improvement-request-not-display-doc-fragments-and-module-utils-directories-content-on-the-documentation-tab-of-a-collection/7628/4 "2024-08-05T20:33:21Z")
I’m a bit torn here, but I tend to agree that they should be shown. This was a much more annoying problem with the old Galaxy since there everything that wasn’t a module was summed up under “plugin”, see for example the “Content” section for [Ansible Galaxy](https://old-galaxy.ansible.com/community/general) - the module utils and docs fragments there are pretty much drown the other plugins by sheer mass. Fortunately this is no longer a problem with galaxy\_ng, since there you can filter by plugin type directly ([Ansible Galaxy](https://galaxy.ansible.com/ui/repo/published/community/general/content/)). If anything I would change the order so that module utils and doc fragments show up at the end of the filter list, since they tend to be least relevant for users. (Most users are not plugin/module developers.) > [@Denney-tech](#): > > If anything, I would prefer the UI to organize the “Documentation” page by the same content types as the “Contents” page. That would make it less confusing, even if there is no documentation being rendered. I fully agree here; the current separation into “Modules” and “Plugins” (and “Roles” and “Playbooks” I guess, if the collections have such) is very coarse, and for community.general it’s pretty useless since it’s a very long list of every kind of plugin: filter, test, cache plugin, inventory plugin, lookup, module utils, docs fragment, … I would also not show undocumentable plugins here (like module utils and docs fragments and plugin utils) from the Documentation tab completely. ---
**Author:** ![Andersson007](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/andersson007/32/89_2.png) [@Andersson007](https://forum.ansible.com/u/Andersson007)\ **Post date:** [August 6, 2024, 5:38am UTC](https://forum.ansible.com/t/ui-improvement-request-not-display-doc-fragments-and-module-utils-directories-content-on-the-documentation-tab-of-a-collection/7628/5 "2024-08-06T05:38:51Z")
> [@felixfontein](#): > > I would also not show undocumentable plugins here (like module utils and docs fragments and plugin utils) from the Documentation tab completely. Ah, now i see, i ended up in the Documentation tab after clicking something undocumented in the Content tab. That’s how i got confused… I agree displaying everything in the Content tab makes sense but in the Documentation tab only documented entities. I’ll update the description. Thanks! ---
**Author:** ![bcoca](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/bcoca/32/9269_2.png) [@bcoca](https://forum.ansible.com/u/bcoca)\ **Post date:** [August 6, 2024, 3:36pm UTC](https://forum.ansible.com/t/ui-improvement-request-not-display-doc-fragments-and-module-utils-directories-content-on-the-documentation-tab-of-a-collection/7628/6 "2024-08-06T15:36:37Z")
‘undocumentable’ should still be listed, just not have a docs link ---
**Author:** ![felixfontein](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/felixfontein/32/7530_2.png) [@felixfontein](https://forum.ansible.com/u/felixfontein)\ **Post date:** [August 6, 2024, 5:11pm UTC](https://forum.ansible.com/t/ui-improvement-request-not-display-doc-fragments-and-module-utils-directories-content-on-the-documentation-tab-of-a-collection/7628/7 "2024-08-06T17:11:33Z")
They should still be listed under content, but not under documentation. ---
**Author:** ![domq](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/domq/32/974_2.png) [@domq](https://forum.ansible.com/u/domq)\ **Post date:** [August 26, 2026, 3:07pm UTC](https://forum.ansible.com/t/ui-improvement-request-not-display-doc-fragments-and-module-utils-directories-content-on-the-documentation-tab-of-a-collection/7628/8 "2026-08-26T15:07:29Z")
Hi Brian, thanks for all your work on Ansible. As far as I’m concerned, understanding that module\_utils are undocumentable was a challenge in and of itself! Perhaps that fact could be mentioned in the Developer Guide.