=======================================================
#ansible-docs: Documentation Working Group Supplemental
=======================================================


Meeting started by samccann at 15:30:43 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2020-11-12/documentation_working_group_supplemental.2020-11-12-15.30.log.html
.



Meeting summary
---------------
* openning chatter  (samccann, 15:30:56)

* Personas  (samccann, 15:34:36)
  * first thoughts on personas -
    https://etherpad.opendev.org/p/ansible-documentation-split
    (samccann, 15:35:27)
  * not a clear boundary between 'users' and 'creators' in this sense.
    some places will hand a user a playbook and tell them to write their
    own inventory.  Other places the user is the creator as well.
    (samccann, 15:51:12)
  * one option for 'release independent' developer guides - put all the
    version-specific information in one guide. So 'in ansible-base...do
    this... in ansible-core.2.11, do this other thing, etc.  (samccann,
    15:57:20)
  * Community guide and much of the developer guide content could be
    release-independent  (samccann, 16:00:45)
  * testing info in the dev guide might be core-specific and we'd need a
    separate testing section for collection developers etc  (samccann,
    16:01:40)

* release dependent vs independent docs  (samccann, 16:02:21)
  * we have started maintaining some pages only in devel and stubbing
    out the info in older versions. release and maintenance, porting
    guides..  (samccann, 16:08:05)
  * LINK: https://docs.ansible.com/ansible/devel/dev_guide/
    (https://github.com/ansible/ansible/tree/devel/docs/docsite/rst/dev_guide)
    (gundalow, 16:10:43)
  * LINK: https://docs.ansible.com/ansible/latest/community/
    (felixfontein, 16:17:12)
  * consider one dev guide, with separate 'chapters' for Ansible
    developer vs ansible-core developer.  Same with user-creater
    personas - not separate books, but separate sections within a book
    for example  (samccann, 16:22:18)

* Next Steps  (samccann, 16:24:26)
  * our goal for the ansible vs ansible-core split is to have a
    non-versioned docs-set for developers alongside existing versioned
    docs, with content that starts to explain the differences
    (samccann, 16:31:28)
  * next steps - create a proposed TOC etc for next week's discussion
    (samccann, 16:39:07)
  * ACTION: gwmngilfen and acozine to work on the docs survey
    (samccann, 16:40:23)
  * Tentative schedule for 2.11:
    https://hackmd.io/y7BBcweNR3aRVLuMbKkDxw  (samccann, 16:43:24)

Meeting ended at 16:43:49 UTC.




Action Items
------------
* gwmngilfen and acozine to work on the docs survey




Action Items, by person
-----------------------
* acozine
  * gwmngilfen and acozine to work on the docs survey
* gwmngilfen
  * gwmngilfen and acozine to work on the docs survey
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* samccann (102)
* acozine (53)
* felixfontein (32)
* abadger1999 (26)
* gundalow (21)
* dmsimard (20)
* gwmngilfen (14)
* zodbot (12)
* bcoca (5)
* dericcrago (5)
* geerlingguy (4)
* cyberpear (2)
* lmodemal (1)
* cybette (1)




Generated by `MeetBot`_ 0.1.4

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