===========================================
#ansible-docs: Docs Working Group aka DaWGs
===========================================


Meeting started by acozine at 14:31:24 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2020-11-24/docs_working_group_aka_dawgs.2020-11-24-14.31.log.html
.



Meeting summary
---------------
* opening chatter  (acozine, 14:31:47)

* slimming down the tarballs by removing docs  (acozine, 14:36:02)
  * Compressed size w/o docs is 28MB vs 29MB today. Installing took 90
    sec w/o docs vs 100 sec with  (samccann, 14:43:27)
  * decision was made that it wasn't worth removing docs from the
    tarballs at this point.  (samccann, 14:43:52)

* uses of the collection `/docs/` folder  (acozine, 14:44:33)
  * some ideas about the collections /docs folder etc -
    https://hackmd.io/pPeMLaFYSt2W8RAqm-ZkXA  (samccann, 14:48:08)
  * the goal is to allow collection owners to write 'user guide' and
    more complex examples etc within the collection /docs folder and
    then render them in either docs.ansible.com or some future galaxy-ng
    (samccann, 14:52:48)
  * we could only include /docs that are explicitly suggested by the
    collection - e.g. looking ad docs/anstibull.yml file to find rst
    files to include  (samccann, 14:56:39)
  * ACTION: samccann ask galaxy team what they render today - md/rst and
    if they look at all in the /docs folder  (samccann, 15:02:35)
  * whateve solution we have for collection /docs needs to cover roles,
    playbooks, as well as any other guides collectoin owners want to
    create  (samccann, 15:16:06)
  * ACTION: - we need to get involved in how filter/test docs are
    structured, how the collection /docs folder works, how roles
    documenttion will work.. many seats... many tables  (samccann,
    15:20:15)
  * would like the collection index to have collection defined: Summary
    section, auto generated plugin index, links to static content
    section.  (abadger1999, 15:32:13)
  * we should put collection name and collection version onto the
    collection index page (regardless of how the rest of the page is
    structured)  (abadger1999, 15:34:27)
  * see how puppet does some of this
    https://forge.puppet.com/modules/puppetlabs/stdlib - with  tabs for
    changelogs, example foler from github etc  (samccann, 15:34:47)
  * ACTION: abadger1999 to do a slight mockup of what a new collectoin
    page could look like  (samccann, 15:38:09)

* docs user survey  (acozine, 15:43:45)
  * revised user survey draft https://hackmd.io/JemYBo_8QbqqO9cULo3rJQ#
    (samccann, 15:47:23)
  * Sections 1 and 2 should tell us how well our documentation is doing
    (samccann, 15:47:48)
  * Section 3 lets us "slice and dice" the data by different types of
    users  (samccann, 15:48:11)
  * feedback deadline is Dec 1 so we can get the survey link into the
    next Bullhorn  (samccann, 15:57:14)

* open floor  (acozine, 15:57:40)
  * please provide feedback by Dec 3 on Separating Ansible 3.0.0
    collection docs from ansible-core -
    https://hackmd.io/TQmzyhCUSSKa22iFR_079A?both  (samccann, 16:00:50)
  * No supplementary meeting on Nov. 26, since it's Thanksgiving Day for
    the US-based docs team  (acozine, 16:01:43)

Meeting ended at 16:07:04 UTC.




Action Items
------------
* samccann ask galaxy team what they render today - md/rst and if they
  look at all in the /docs folder
* - we need to get involved in how filter/test docs are structured, how
  the collection /docs folder works, how roles documenttion will work..
  many seats... many tables
* abadger1999 to do a slight mockup of what a new collectoin page could
  look like




Action Items, by person
-----------------------
* abadger1999
  * abadger1999 to do a slight mockup of what a new collectoin page
    could look like
* samccann
  * samccann ask galaxy team what they render today - md/rst and if they
    look at all in the /docs folder
* **UNASSIGNED**
  * - we need to get involved in how filter/test docs are structured,
    how the collection /docs folder works, how roles documenttion will
    work.. many seats... many tables




People Present (lines said)
---------------------------
* acozine (122)
* samccann (70)
* felixfontein (49)
* abadger1999 (36)
* dmsimard (15)
* baptistemm (12)
* zodbot (11)
* gwmngilfen (5)
* lmodemal (4)
* gundalow (2)
* aminvakil (1)
* cybette (1)




Generated by `MeetBot`_ 0.1.4

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