samccann's meeting titled "Documentation Working Group supplemental
meeting" ended in #ansible-docs
by notifications@fedoraproject.org
Notification time stamped 2021-01-07 16:55:52 UTC
===============================================================
#ansible-docs: Documentation Working Group supplemental meeting
===============================================================
Meeting started by samccann at 15:31:01 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2021-01-07/documentation_w...
.
Meeting summary
---------------
* opening chatter (samccann, 15:31:15)
* status update (samccann, 15:36:06)
* problem statement - the ansible PyPI package called version 3.0.0
will beta at start of Feb 2021 timeframe and some time after that,
the ansible-core PyPI package called version 2.11 will release. We
need a way for docs to reflect the two “streams” of versions.
Ansible 3.0.0 docs need to reference back to ansible-base 2.10 docs
for all Ansible features that are not collections. (samccann,
15:36:18)
* proposal docs.ansible.com/ansible becomes Ansible the Package
documentation. docs.ansible.com/ansible-core becomes the core only
documentation. (samccann, 15:36:32)
* current status Reviewing internally to get full buyin from
management later this week (samccann, 15:36:50)
* Today's meeting goals - implementation - assuming we get approval,
how can we accomplish all this in 3 weeks and 2 days (to have a
docsite for 3.0.0 beta) (samccann, 15:37:14)
* agenda -
https://github.com/ansible/community/issues/579#issuecomment-750471248
(samccann, 15:37:36)
* what must we accomplish by Feb 2 and what can we push off to a later
date (samccann, 15:38:00)
* proposal https://hackmd.io/TQmzyhCUSSKa22iFR_079A?both (gundalow,
15:38:34)
* AGREED: we need a docsite that reflects Ansible 3.0.0, that doesn't
mess up older releases, and that has /devel/ for ansible-core
(samccann, 15:41:24)
* AGREED: we will not try to unversion any existing docs (aka
community/developer guide) by Feb 2. (samccann, 15:53:43)
* LINK:
https://docs.ansible.com/ansible/devel/roadmap/COLLECTIONS_3_0.html
that seems to refer to 2.11 (dericcrago, 16:00:23)
* If a user installs Ansible 3.x it will never install ansible=core
2.11 (samccann, 16:07:41)
* Ansible 4.x would never install core-2.12 either (samccann,
16:09:12)
* Docs will reflect what is in Ansible the package and not attempt to
match what a user may manually upgrade after that (samccann,
16:14:53)
* new repo for new community guides etc (samccann, 16:16:39)
* We know there are various gaps in the community documentation,
especially around how to look after (maintain, own, manage)
Collection & Collection repos. We have a lot of brand new docs to
write. Currently we've been using
https://github.com/ansible-collections/overview to host some RST.
Though this was always viewed as a short term solution (gundalow,
16:18:39)
* I wonder if we could start a new top level docsite for these brand
new docs (docs.ansible.com/community) (gundalow, 16:19:28)
* Example index page
https://hackmd.io/uKhHRhFUStG_bVNhY10cLQ#New-Index-structure
(gundalow, 16:19:45)
* next steps (samccann, 16:36:06)
* ACTION: samccann abadger1999 to continue discussing how to build
this 3.x docsite from some 2.10 rst files later today (samccann,
16:44:52)
* Open Floor (samccann, 16:44:59)
Meeting ended at 16:55:52 UTC.
Action Items
------------
* samccann abadger1999 to continue discussing how to build this 3.x
docsite from some 2.10 rst files later today
Action Items, by person
-----------------------
* abadger1999
* samccann abadger1999 to continue discussing how to build this 3.x
docsite from some 2.10 rst files later today
* samccann
* samccann abadger1999 to continue discussing how to build this 3.x
docsite from some 2.10 rst files later today
* **UNASSIGNED**
* (none)
People Present (lines said)
---------------------------
* samccann (121)
* abadger1999 (52)
* acozine (44)
* gundalow (37)
* zodbot (11)
* dmsimard (10)
* dericcrago (7)
* bcoca (3)
* tadeboro (3)
* lmodemal (3)
* felixfontein (1)
* zbr (1)
Generated by `MeetBot`_ 0.1.4
.. _`MeetBot`: http://wiki.debian.org/MeetBot
https://meetbot.fedoraproject.org/ansible-docs/2021-01-07/documentation_w...
--
You received this message due to your preference settings at
https://apps.fedoraproject.org/notifications/fmnmeetingminutes.id.fedorap...