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


Meeting started by acozine at 15:00:50 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2021-05-11/docs_working_group_aka_dawgs.2021-05-11-15.00.log.html
.



Meeting summary
---------------
* opening chatter  (acozine, 15:00:55)

* copyright notices  (gundalow, 15:08:51)
  * LINK: https://github.com/ansible/ansible/pull/74643   (acozine,
    15:09:17)
  * updating copyright on docs.ansible.com to drop year/date and credit
    `Ansible project contributors` see
    https://github.com/ansible/ansible/pull/74643/files  (acozine,
    15:14:17)

* update on traffic to existing Scenario Guide TOCs  (acozine, 15:15:14)
  *
    https://docs.ansible.com/ansible/latest/scenario_guides/cloud_guides.html
    gets 1.2k visitors a month. That is 0.2% of all docs traffic
    (samccann, 15:16:45)
  * and 6% of all scenario guide traffic  (samccann, 15:17:05)
  * LINK: https://docs.ansible.com/ansible/latest/scenario_guides/
    (acozine, 15:22:30)
  * AGREED: stub out individual scenario guides to point to their new
    locations as they are moved. Add the stubs to a robots.txt file on
    the server so google ignores them  (samccann, 15:38:06)

* updates on long-running topics  (acozine, 15:39:19)
  * - breadcrumbs testing seems to be good. abadger to release and
    updated antsibull that re-enables it  (samccann, 15:44:23)
  * making some progress on testing the move of a scenario guide to a
    collection. All still WIP  (samccann, 15:46:08)
  * the moved guides will need a specific anchor like ..
    _ansible_collections.community.docker.docsite.scenario_guide:
    (samccann, 15:47:17)

* options for including rst documentation in the collection index pages
  (acozine, 15:48:54)
  *
    https://github.com/felixfontein/community.docker/blob/scenario-guide/docs/docsite/index.yml
    produces https://ansible.fontein.de/collections/community/docker/
    (samccann, 15:55:33)
  * we are looking for a way to inject rst into the existing
    autogenerated collection index page.  (samccann, 15:55:58)
  * so the index.yml defines what those additional materials should be
    called on the existing index page, under that collection.
    (samccann, 15:56:26)
  * AGREED: use felixfontein's existing PR for collections additional
    docs from the /docs/ folder, with one small change - name the
    top-level YAML file `extra-docs.yml`  (acozine, 16:07:28)
  * ACTION: acozine to update AWS collection PR to match (and fix its
    anchors)  (acozine, 16:07:57)

* open floor  (acozine, 16:08:29)
  * LINK: https://github.com/ansible/ansible/pull/74245   (abadger1999,
    16:09:10)
  * https://github.com/ansible/ansible/pull/74245 breaks html docs for
    `set_fact` and `user`. We should consider reverting it  (samccann,
    16:14:50)
  * https://github.com/ansible/ansible/issues/73995 relates to this
    problem  (acozine, 16:16:43)
  * example of broken link -
    https://docs.ansible.com/ansible/devel/collections/ansible/builtin/set_fact_module.html
    (samccann, 16:22:24)
  * ACTION: acozine to summarize the problems with
    https://github.com/ansible/ansible/pull/74245 in a GitHub issue
    (acozine, 16:22:27)

Meeting ended at 16:25:44 UTC.




Action Items
------------
* acozine to update AWS collection PR to match (and fix its anchors)
* acozine to summarize the problems with
  https://github.com/ansible/ansible/pull/74245 in a GitHub issue




Action Items, by person
-----------------------
* acozine
  * acozine to update AWS collection PR to match (and fix its anchors)
  * acozine to summarize the problems with
    https://github.com/ansible/ansible/pull/74245 in a GitHub issue
* **UNASSIGNED**
  * (none)




People Present (lines said)
---------------------------
* acozine (140)
* samccann (79)
* felixfontein (45)
* abadger1999 (39)
* zodbot (14)
* gundalow (8)
* tremble (4)
* dericcrago (2)
* cyberpear (1)




Generated by `MeetBot`_ 0.1.4

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