Notification time stamped 2021-06-22 16:20:05 UTC
====================================================
#ansible-docs: Documentation Working Group aka DaWGs
====================================================
Meeting started by acozine at 15:01:01 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2021-06-22/documentation_w...
.
Meeting summary
---------------
* opening chatter (acozine, 15:01:07)
* semantic markup (acozine, 15:11:04)
* summary issue:
https://github.com/ansible/ansible/issues/75054
(acozine, 15:12:19)
* LINK:
https://github.com/ansible/ansible/pull/73137 (felixfontein,
15:17:34)
* the proposed semantic markup is O(k) for option names, O(k=v) for
option key/values, V(v) for option values, E(env) for env variables,
and P(community.general.foo#lookup) for plugin references
(samccann, 15:19:31)
* ACTION: acozine to followup with core, navigator? and galaxy on the
proposed new markup options (samccann, 15:24:34)
* correction to the vote above: semantic markup macros: O(k) for
option names, O(k=v) for option key/values, V(v) for option values,
E(env) for env variables, and P(FQCN#plugintype) for plugin
references; existing markup macros will remain (acozine, 15:31:31)
* AGREED: semantic markup macros: O(k) for option names, O(k=v) for
option key/values, V(v) for option values, E(env) for env variables,
and P(FQCN#plugintype) for plugin references; existing markup macros
will remain (samccann, 15:34:18)
* IBM style guide says parameter names are 'bold monospace' and values
are 'monospace' but key-value pairs are monospace only. (samccann,
15:44:11)
* AGREED: follow IBM style guide as much as we can with RST for these
semantic markup options (samccann, 16:04:50)
* open floor (acozine, 16:05:17)
* rendering bold mono might require a custom RST role, which can be
achieved by a Sphinx extension (which the antsibull sphinx extension
happens to be) (felixfontein, 16:06:36)
* ACTION: review and merge backport of ansible sphinx theme to 2.11
https://github.com/ansible/ansible/pull/75058 (samccann, 16:08:36)
* ACTION: abadger1999 to review and (hopefully) merge antsibull PRs
284, 283, 285, and then 282 today. (abadger1999, 16:16:53)
* ACTION: with a new version of antsibull (potentially today?),
getting
https://github.com/ansible/ansible/pull/75059 (with == 0.7.0
and not >= 0.7.0) merged would be good, as well as getting
https://github.com/ansible/ansible/pull/74956 merged (probably
first, so it doesn't collect more potential conflicts) (samccann,
16:18:19)
Meeting ended at 16:20:05 UTC.
Action Items
------------
* acozine to followup with core, navigator? and galaxy on the proposed
new markup options
* review and merge backport of ansible sphinx theme to 2.11
https://github.com/ansible/ansible/pull/75058
* abadger1999 to review and (hopefully) merge antsibull PRs 284, 283,
285, and then 282 today.
* with a new version of antsibull (potentially today?), getting
https://github.com/ansible/ansible/pull/75059 (with == 0.7.0 and not
= 0.7.0) merged would be good, as well as getting
https://github.com/ansible/ansible/pull/74956 merged (probably first,
so it doesn't collect more potential conflicts)
Action Items, by person
-----------------------
* abadger1999
* abadger1999 to review and (hopefully) merge antsibull PRs 284, 283,
285, and then 282 today.
* acozine
* acozine to followup with core, navigator? and galaxy on the proposed
new markup options
* **UNASSIGNED**
* review and merge backport of ansible sphinx theme to 2.11
https://github.com/ansible/ansible/pull/75058
* with a new version of antsibull (potentially today?), getting
https://github.com/ansible/ansible/pull/75059 (with == 0.7.0 and not
= 0.7.0) merged would be good, as well as getting
https://github.com/ansible/ansible/pull/74956 merged (probably
first, so it doesn't collect more potential conflicts)
People Present (lines said)
---------------------------
* acozine (111)
* felixfontein (75)
* samccann (65)
* abadger1999 (23)
* tadeboro (20)
* briantist (14)
* zodbot (11)
* lmodemal (7)
Generated by `MeetBot`_ 0.1.4
.. _`MeetBot`:
http://wiki.debian.org/MeetBot
https://meetbot.fedoraproject.org/ansible-docs/2021-06-22/documentation_w...
--
You received this message due to your preference settings at
https://apps.fedoraproject.org/notifications/fmnmeetingminutes.id.fedorap...