#ansible-docs: Documentation Working Group aka DaWGs

Meeting summary

1. opening chatter (samccann, 16:00:27)
   
2. Action Item Review (samccann, 16:03:50)
   1. Ansible 5 goes out today...and so will the docs! (samccann, 16:04:20)
   2. agenda -https://github.com/ansible/community/issues/579#issuecomment-976929469 (samccann, 16:04:36)
   3. for expand/collapse Pr - need to rebase and then attempt some better formatting because a reader may not even notice there is a collapsed section there. (samccann, 16:07:18)
   4. ACTION: - rebase and improve visibility formatting for collapsed version of expand/collapse pr https://github.com/ansible/ansible/pull/75695 (samccann, 16:08:07)
   
   
3. setting docs priorities for 2022 (samccann, 16:08:37)
   1. we have test docs and community docs that need heavy work. Then navigation/toc/general findability. Search has problems. Scenario guides still going stale (samccann, 16:10:30)
   2. we need to move forward on responsiveness and semantic markup (samccann, 16:13:11)
   3. on search - we should try for faceted search that includes version and module vs non-module search results (samccann, 16:18:03)
   4. community team would like their community docs repo better integrated with docs.ansible.com (samccann, 16:19:54)
   
   
4. semantic markup (samccann, 16:20:53)
   1. created an internal to Red Hat tracking ticket for the downstream impact (samccann, 16:21:06)
   2. ACTION: @samccann to push more on the community and internal RH tickets for semantic markup decisions (samccann, 16:28:56)
   
   
5. responsive plugin tables (samccann, 16:30:15)
   1. https://github.com/ansible-community/antsibull/pull/335 (samccann, 16:30:28)
   2. ACTION: samccann_ to verify /latest/ publication uses known-good requirements file and /devel/ uses requirements.txt with an open antsibull version (samccann, 16:37:43)
   3. https://gist.github.com/felixfontein/18b1763ca2a5320808225c4121b50791 (felixfontein, 16:43:28)
   4. ACTION: gwmngilfen to review the proposed schema (gwmngilfen-work, 16:45:02)
   
   
6. Open Floor (samccann, 16:59:33)

Action items

1. - rebase and improve visibility formatting for collapsed version of expand/collapse pr https://github.com/ansible/ansible/pull/75695
2. @samccann to push more on the community and internal RH tickets for semantic markup decisions
3. samccann_ to verify /latest/ publication uses known-good requirements file and /devel/ uses requirements.txt with an open antsibull version
4. gwmngilfen to review the proposed schema

Action items, by person

1. samccann
   1. @samccann to push more on the community and internal RH tickets for semantic markup decisions
   2. samccann_ to verify /latest/ publication uses known-good requirements file and /devel/ uses requirements.txt with an open antsibull version
2. UNASSIGNED
   1. - rebase and improve visibility formatting for collapsed version of expand/collapse pr https://github.com/ansible/ansible/pull/75695
   2. gwmngilfen to review the proposed schema

People present (lines said)

1. samccann (90)
2. felixfontein (48)
3. bcoca (23)
4. gwmngilfen-work (14)
5. zodbot (9)
6. acozine (6)
7. remindbot[m] (3)
8. ariordan (2)
9. Gwmngilfen (0)