#ansible-docs: DaWGs aka Documentation Working Group Supplemental meeting

Meeting summary

1. opening chatter (samccann, 15:32:23)
   
2. Status of the docsite split proposal (samccann, 15:36:39)
   1. the proposal is at https://hackmd.io/TQmzyhCUSSKa22iFR_079A?both (samccann, 15:37:04)
   2. we have internal buyin to make this happen! (samccann, 15:37:16)
   3. we have a plan for how to achieve this - https://hackmd.io/x0VwaKSYQCaHGJR4LelSEw?view (samccann, 15:38:33)
   4. TL;DR; - two sites with nearly identical documentation for now since we are short on time. They will have separate urls and versions. (samccann, 15:39:13)
   5. tracking issue for all we have to accomplish this month - https://github.com/ansible/ansible/issues/72032 (samccann, 15:40:06)
   
   
3. problems to solve (samccann, 15:46:33)
   1. http://docs.testing.ansible.com/ansible-core/2.11/ (samccann, 15:48:43)
   2. https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#substitution-definitions (acozine, 15:51:01)
   3. https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#substitution-references (acozine, 15:52:26)
   4. https://sublime-and-sphinx-guide.readthedocs.io/en/latest/reuse.html (acozine, 15:54:06)
   5. rst substitutions might work - https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#substitution-definitions and https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#substitution-references (samccann, 15:54:09)
   6. see https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#substitutions for how to do this w separate files (samccann, 15:55:15)
   7. ACTION: lmodemal - attempt sphinx/rst variable substitution for the title (samccann, 15:56:36)
   
   
4. list of problems to solve (samccann, 15:58:40)
   1. this is an older list of problems abadger1999 created a few weeks ago - https://hackmd.io/iDEyihLqRtWnjtOUd3pNYQ (samccann, 15:58:57)
   2. this problem still exists - https://hackmd.io/iDEyihLqRtWnjtOUd3pNYQ#Pipeline-uses-Ansible-version-to-set-the-version-in-the-URL-for-docs (samccann, 16:00:13)
   3. ACTION: samccann to clarify what this problem really means - https://hackmd.io/iDEyihLqRtWnjtOUd3pNYQ#Pipeline-uses-Ansible-version-to-set-the-version-in-the-URL-for-docs (samccann, 16:07:15)
   
   
5. Next Steps (samccann, 16:07:42)
   1. AGREED: we will stop having this extra meeting and fold updates/issues into the regular tuesday DaWGs meetings (samccann, 16:09:22)
   2. acozine working on jenkins build samccann working on makefile lmodemal working on variable subsitution (samccann, 16:10:16)
   3. abadger1999 investigating the antsibull side of this to see if it 'all works' or needs some changes (samccann, 16:10:47)
   4. more information also available on the project board at https://github.com/ansible/ansible/projects/27 (acozine, 16:10:56)
   
   
6. Open Floor (samccann, 16:11:22)

Action items

1. lmodemal - attempt sphinx/rst variable substitution for the title
2. samccann to clarify what this problem really means - https://hackmd.io/iDEyihLqRtWnjtOUd3pNYQ#Pipeline-uses-Ansible-version-to-set-the-version-in-the-URL-for-docs

Action items, by person

1. lmodemal
   1. lmodemal - attempt sphinx/rst variable substitution for the title
2. samccann
   1. samccann to clarify what this problem really means - https://hackmd.io/iDEyihLqRtWnjtOUd3pNYQ#Pipeline-uses-Ansible-version-to-set-the-version-in-the-URL-for-docs

People present (lines said)

1. samccann (71)
2. acozine (30)
3. zodbot (7)
4. lmodemal (6)
5. bcoca (1)
6. dericcrago (1)