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_work... .
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_work...
-- You received this message due to your preference settings at https://apps.fedoraproject.org/notifications/fmnmeetingminutes.id.fedoraproj...