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

Meeting started by samccann at 15:32:15 UTC (full logs).

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)


Meeting ended at 16:14:28 UTC (full logs).

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)


Generated by MeetBot 0.1.4.