docs_working_group_aka_dawgs
14.32
January 14, 2020
ansible-docs
#ansible-docs: Docs Working Group aka DaWGs
Meeting started by acozine at 14:32:02 UTC
(full logs ).
Meeting summary
add new 'advanced' or 'deep dive' page that
describes ansbile's inner workings on how we loop through
plays/tasks and what happens at each stage .. mostly that will
clarify why undefined in loop is not captured by when and other
'mysteries' (bcoca) (samccann ,
14:39:59)
Status Updates (samccann , 14:40:06)
top left search box on devel is now running
swiftype search. Feedback most welcome (samccann ,
14:41:15)
Added writing guidelines for search
optimization (samccann ,
14:42:02)
https://docs.ansible.com/ansible/devel/dev_guide/style_guide/search_hints.html
(samccann ,
14:42:05)
how ansible executes (samccann , 14:45:06)
https://docs.ansible.com/ansible/latest/dev_guide/developing_program_flow_modules.html
(samccann ,
14:45:24)
above link is a possible home for a deep dive
on how ansible executes (samccann ,
14:46:07)
https://www.reddit.com/r/ansible/comments/eo6lwq/why_is_ansible_user_not_defined_when_accessed/fe9dcci/
(acozine ,
14:46:15)
https://www.reddit.com/r/ansible/comments/eo6lwq/why_is_ansible_user_not_defined_when_accessed/fe9dcci/
- where the request came from (samccann ,
14:47:11)
https://www.reddit.com/r/ansible/comments/eo6lwq/why_is_ansible_user_not_defined_when_accessed/
(bcoca ,
14:55:08)
consider a user level page to introduce the
ansible execution tidbits, then a deeper dive in the dev
guide (samccann ,
14:55:20)
ACTION : cbudz to
draft a topic to cover this (samccann ,
14:56:46)
latest user guide updates (acozine , 14:58:07)
http://docs.testing.ansible.com/ansible/devel/user_guide/playbooks_reuse.html
(acozine ,
15:00:16)
looking for feedback on
https://github.com/ansible/ansible/pull/66371 (samccann ,
15:02:20)
http://docs.testing.ansible.com/ansible/devel/user_guide/playbooks_reuse_roles.html
especially (samccann ,
15:02:37)
http://docs.testing.ansible.com/ansible/devel/user_guide/playbooks_tags.html
as well (samccann ,
15:02:52)
linting examples in the documentation (acozine , 15:06:43)
would be great to run ansible-lint against doc
examples in .rst and module docstrings. May require some scripts to
do this w/o having to move all examples into separate .yml
files (samccann ,
15:11:24)
https://github.com/ansible/ansible/issues/58687
- lists top 10 doc pages for Ansible. Good place to start making
improvements (samccann ,
15:15:00)
https://github.com/ansible/ansible/issues/66474
(zbr ,
15:17:58)
https://github.com/ansible/ansible/issues/66474
- new issue to track ansible-lint on docs (samccann ,
15:19:23)
open floor (acozine , 15:22:22)
https://github.com/ansible/ansible/pull/66408
(samccann ,
15:22:52)
Meeting ended at 15:29:22 UTC
(full logs ).
Action items
cbudz to draft a topic to cover this
Action items, by person
cbudz
cbudz to draft a topic to cover this
People present (lines said)
acozine (121)
samccann (57)
bcoca (11)
zbr (9)
cbudz_ (8)
zodbot (6)
cbudz (0)
Generated by MeetBot 0.1.4.