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


Meeting started by samccann at 15:32:15 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2021-01-14/dawgs_aka_documentation_working_group_supplemental_meeting.2021-01-14-15.32.log.html
.



Meeting summary
---------------
* opening chatter  (samccann, 15:32:23)

* Status of the docsite split proposal  (samccann, 15:36:39)
  * the proposal is at https://hackmd.io/TQmzyhCUSSKa22iFR_079A?both
    (samccann, 15:37:04)
  * we have internal buyin to make this happen!  (samccann, 15:37:16)
  * we have a plan for how to achieve this -
    https://hackmd.io/x0VwaKSYQCaHGJR4LelSEw?view  (samccann, 15:38:33)
  * 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)
  * tracking issue for all we have to accomplish this month -
    https://github.com/ansible/ansible/issues/72032  (samccann,
    15:40:06)

* problems to solve  (samccann, 15:46:33)
  * LINK: http://docs.testing.ansible.com/ansible-core/2.11/
    (samccann, 15:48:43)
  * LINK:
    https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#substitution-definitions
    (acozine, 15:51:01)
  * LINK:
    https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#substitution-references
    (acozine, 15:52:26)
  * LINK:
    https://sublime-and-sphinx-guide.readthedocs.io/en/latest/reuse.html
    (acozine, 15:54:06)
  * 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)
  * 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)
  * ACTION: lmodemal - attempt sphinx/rst variable substitution for the
    title  (samccann, 15:56:36)

* list of problems to solve  (samccann, 15:58:40)
  * this is an older list of problems abadger1999 created a few weeks
    ago - https://hackmd.io/iDEyihLqRtWnjtOUd3pNYQ  (samccann, 15:58:57)
  * 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)
  * 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)

* Next Steps  (samccann, 16:07:42)
  * AGREED: we will stop having this extra meeting and fold
    updates/issues into the regular tuesday DaWGs meetings  (samccann,
    16:09:22)
  * acozine working on jenkins build  samccann working on makefile
    lmodemal working on variable subsitution  (samccann, 16:10:16)
  * abadger1999 investigating the antsibull side of this to see if it
    'all works' or needs some changes  (samccann, 16:10:47)
  * more information also available on the project board at
    https://github.com/ansible/ansible/projects/27  (acozine, 16:10:56)

* Open Floor  (samccann, 16:11:22)

Meeting ended at 16:14:28 UTC.




Action Items
------------
* lmodemal - attempt sphinx/rst variable substitution for the title
* 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
-----------------------
* lmodemal
  * lmodemal - attempt sphinx/rst variable substitution for the title
* samccann
  * 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
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* samccann (71)
* acozine (30)
* zodbot (7)
* lmodemal (6)
* bcoca (1)
* dericcrago (1)




Generated by `MeetBot`_ 0.1.4

.. _`MeetBot`: http://wiki.debian.org/MeetBot