maybe there is a way to add expand/collapse to
sphinx output so users can more easily expand the examples section -
https://guido.vonrudorff.de/2013/sphinx-documentation-collapse-content/(samccann,
15:21:01)
an example of a good 'pattern' book for
examples is
https://docs.ansible.com/ansible/latest/user_guide/complex_data_manipulation.html(samccann,
15:23:10)
That particular sphinx expance uses jquery and
might not be good on screen readers(samccann,
15:23:42)
an example pattern book should also include
output(samccann,
15:24:01)
for expand collapse - see
https://github.com/readthedocs/sphinx_rtd_theme/issues/402 for some
hints(samccann,
15:25:09)
another useful expand/collapse thread -
https://stackoverflow.com/questions/2454577/sphinx-restructuredtext-show-hide-code-snippets/60394068#60394068(samccann,
15:27:37)
some sphinx extension which generates
<details></details> (with
<summary><summary/>) would probably be best(samccann,
15:28:49)
ACTION: samccann to
open an issue on the ansible theme to ask for expand/collapse
capability(samccann,
15:29:25)
this would be good on something like the
pattern example pages. we could either expand/collapse each code
snippet example, or we could divide each example into three parts
(data, expression, output) and collapse/expand them
separately(samccann,
15:32:30)
and possibly expand to module docs in the
future(samccann,
15:32:49)
ACTION: samccann
create a topic issue for the community WG on community-contributed
examples(samccann,
15:41:38)
install instructions for debian are woefully
outdated (trusty is old, calver is newer) -
https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#installing-ansible-on-debian(samccann,
15:57:50)
on ubuntu vs debian releases
https://libera.ems.host/_matrix/media/r0/download/libera.chat/7e35f2f92ea3844b184705c5f1f2f053df59ffc7/message.txt(samccann,
16:01:47)
ACTION: dericcrago to
open a PR to update the debian install instrtuctions(samccann,
16:04:04)
briantist looking for collection maintainers to
collaborate on docs build enhancements(acozine,
16:07:14)
some details on testing collection docs before
merging -
https://github.com/ansible-collections/community.hashi_vault/blob/main/.github/workflows/docs.yml(samccann,
16:11:56)