#ansible-docs: Documentation Working Group aka DaWGs

Meeting started by samccann at 15:01:19 UTC (full logs).

Meeting summary

  1. opening chatter (samccann, 15:01:26)
  2. Action Item review (samccann, 15:05:12)
    1. tracking issue for docs needs for ansible-core 2.12 release - https://github.com/ansible/ansible/issues/75664 (samccann, 15:06:35)

  3. docs approach for new module attributes (samccann, 15:09:10)
    1. https://github.com/ansible/ansible/issues/75164 (samccann, 15:09:58)
    2. if a module does nothing (doesn't include action_common_attributes) then no docs changes. (samccann, 15:16:43)
    3. if modules use this new docs attribute fragment, what happens if core adds more things to this common fragment? (samccann, 15:21:49)
    4. quite a few plugin types, quite a few of the entries make no sense (samccann, 15:28:40)
    5. a table of all the attributes, especially where most are not overridden, can be information overload for the user https://user-images.githubusercontent.com/30267855/132581892-e27959da-085f-42df-996e-01933be09816.png (samccann, 15:29:11)
    6. general consensus is to use support:uknown in the action_common_attributes and then any module using it must override for what it actually supports. Docs will display those overrides only. (samccann, 15:53:17)

  4. Open Floor (samccann, 15:56:08)
    1. https://github.com/ansible/ansible/pull/75705 (felixfontein, 16:04:22)


Meeting ended at 16:20:25 UTC (full logs).

Action items

  1. (none)


People present (lines said)

  1. samccann (87)
  2. abadger1999 (71)
  3. felixfontein (43)
  4. zodbot (13)
  5. tadeboro (11)
  6. ariordan[m] (6)
  7. gwmngilfen-work (3)
  8. gundalow (2)
  9. dericcrago (1)


Generated by MeetBot 0.3.