#ansible-docs: Documentation Working Group aka DaWGs

Meeting started by samccann at 15:02:23 UTC (full logs).

Meeting summary

  1. Action Items (samccann, 15:05:13)
    1. closed samccann to inform community-writers about EE epic for a place to help out editorially and with info architecture etc (samccann, 15:05:23)
    2. closed issue in community-topic for requesting cheatsheet help and on reddit as well - https://github.com/ansible-community/community-topics/issues/232 (samccann, 15:05:34)

  2. Moving docs out of ansible/ansible (samccann, 15:08:25)
    1. this is part of putting package docs under ansible steering committee/community control. See https://github.com/ansible-community/community-topics/issues/243 (samccann, 15:08:39)
    2. an interim step is to move all docs out to ansible/ansible-documentation. From there, we can iterate faster to get to the point where the community package docs are under community control (likely another repo in ansible-community org) and separate from core docs. (samccann, 15:08:50)
    3. starting this Thursday, we'll test out the new ansible/ansible-documentation repo and publish devel docs from there. (samccann, 15:10:51)
    4. this also means docs PRs in ansible/ansible in the next two weeks will be asked to move over to ansible/ansible-documentation (samccann, 15:11:12)

  3. Documentation updates (samccann, 15:30:27)
    1. removing local copies of interphinx links - https://github.com/ansible/ansible/pull/80994 (samccann, 15:30:39)
    2. https://github.com/ansible/ansible/pull/80994#issuecomment-1589265337 (samccann, 15:35:37)
    3. considering how to handle how-to guides that include more than one project. See the EE issues for an example - https://github.com/ansible-community/community-team/issues/243#issuecomment-1588912447 (samccann, 15:39:08)
    4. should a quickstart tutorial include more than one project? General agreement is EEs do need to talk about more than one project. Just building an EE is useless w/o showing how to use the end result for example (samccann, 15:42:25)
    5. https://github.com/ansible/community-docs/pull/60 is the content we're talking about (samccann, 15:46:00)

  4. Open Floort (samccann, 15:56:30)
    1. looking for feedback on how to handle enviroment variables - https://github.com/ansible-community/antsibull-docs/issues/164 (samccann, 15:58:17)


Meeting ended at 16:04:35 UTC (full logs).

Action items

  1. (none)


People present (lines said)

  1. samccann (93)
  2. felixfontein (35)
  3. oranod (22)
  4. bcoca (21)
  5. briantist (11)
  6. zodbot (10)
  7. TVo[m] (3)
  8. sutapa_bhattacha (2)
  9. sutapa_bhattacharjee (0)
  10. TVo (0)
  11. Don (0)
  12. Naro (0)


Generated by MeetBot 0.4.