acozine's meeting titled "Docs Working Group aka DaWGs" ended in
#ansible-docs
by notifications@fedoraproject.org
Notification time stamped 2020-11-24 16:07:04 UTC
===========================================
#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_gr...
.
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
https://meetbot.fedoraproject.org/ansible-docs/2020-11-24/docs_working_gr...
--
You received this message due to your preference settings at
https://apps.fedoraproject.org/notifications/fmnmeetingminutes.id.fedorap...