documentation_working_group_aka_dawgs
MINUTES

#ansible-docs: Documentation Working Group aka DaWGs

Meeting started by samccann at 16:00:03 UTC (full logs).

Meeting summary

  1. opening chatter (samccann, 16:00:09)
    1. ACTION: samccann to change room alert to 31 hrs for help wanted nag (samccann, 16:01:01)

  2. documentation updates (samccann, 16:04:45)
  3. Community examples (samccann, 16:07:31)
    1. we're open for community base Ansible examples here - https://github.com/ansible-community/community-examples (samccann, 16:13:28)
    2. https://github.com/ansible/ansible/issues?q=is%3Aissue+is%3Aopen+survey (samccann, 16:16:11)
    3. a couple more docs survey feedback issues we could use help on - https://github.com/ansible/ansible/issues?q=is%3Aissue+is%3Aopen+survey (samccann, 16:16:33)
    4. splitting up the community guide into getting started, core, and collection contributor guides - https://github.com/ansible/ansible/pull/76764 (WIP) (samccann, 16:21:48)

  4. generating docs for collections (samccann, 16:22:37)
    1. GitHub actions and reusable workflows you can use to generate documentation in your own collection repository on GitHub -https://github.com/ansible-community/github-docs-build (samccann, 16:23:50)
    2. actively in use in `community.docer` and `community.hashi_vault` (samccann, 16:25:56)
    3. https://github.com/ansible-community/github-docs-build/wiki (acozine, 16:34:49)
    4. some early docs available at https://github.com/ansible-community/github-docs-build/wiki (samccann, 16:35:13)

  5. semantic markup (samccann, 16:35:53)
    1. we found out definitively that this will impact Automation Hub/ GalaxyNG so need to coordinate with that team (samccann, 16:37:01)
    2. if anyone has additional ideas for semantic markup improvements, now's the time to get them in before the design goes for internal review with the GalaxyNG teeam! (samccann, 16:41:10)
    3. proposal - https://hackmd.io/VjN60QSoRSSeRfvGmOH1lQ (samccann, 16:42:04)

  6. Open Floor (samccann, 16:56:32)
    1. ACTION: felixfontein to write up an addition to the semantic markup to support seealso: for plugins as well as modules (samccann, 16:57:09)
    2. ACTION: samcann acozine - to review https://github.com/ansible/ansible/issues/76609 in terms of how we can add to the cheatsheet and/or create split controller docs to help out here (and eventual URL added to `ansible-test --help1` output (samccann, 17:04:59)


Meeting ended at 17:08:05 UTC (full logs).

Action items

  1. samccann to change room alert to 31 hrs for help wanted nag
  2. felixfontein to write up an addition to the semantic markup to support seealso: for plugins as well as modules
  3. samcann acozine - to review https://github.com/ansible/ansible/issues/76609 in terms of how we can add to the cheatsheet and/or create split controller docs to help out here (and eventual URL added to `ansible-test --help1` output


Action items, by person

  1. acozine
    1. samcann acozine - to review https://github.com/ansible/ansible/issues/76609 in terms of how we can add to the cheatsheet and/or create split controller docs to help out here (and eventual URL added to `ansible-test --help1` output
  2. felixfontein
    1. felixfontein to write up an addition to the semantic markup to support seealso: for plugins as well as modules
  3. samccann
    1. samccann to change room alert to 31 hrs for help wanted nag


People present (lines said)

  1. samccann (93)
  2. acozine (40)
  3. felixfontein (37)
  4. briantist (34)
  5. bcoca (15)
  6. zodbot (8)
  7. gundalow (4)
  8. remindbot[m] (3)


Generated by MeetBot 0.4.