slimming down the tarballs by removing docs(acozine, 14:36:02)
Compressed size w/o docs is 28MB vs 29MB today.
Installing took 90 sec w/o docs vs 100 sec with(samccann,
14:43:27)
decision was made that it wasn't worth removing
docs from the tarballs at this point.(samccann,
14:43:52)
uses of the collection `/docs/` folder(acozine, 14:44:33)
some ideas about the collections /docs folder
etc - https://hackmd.io/pPeMLaFYSt2W8RAqm-ZkXA(samccann,
14:48:08)
the goal is to allow collection owners to write
'user guide' and more complex examples etc within the collection
/docs folder and then render them in either docs.ansible.com or some
future galaxy-ng(samccann,
14:52:48)
we could only include /docs that are explicitly
suggested by the collection - e.g. looking ad docs/anstibull.yml
file to find rst files to include(samccann,
14:56:39)
ACTION: samccann ask
galaxy team what they render today - md/rst and if they look at all
in the /docs folder(samccann,
15:02:35)
whateve solution we have for collection /docs
needs to cover roles, playbooks, as well as any other guides
collectoin owners want to create(samccann,
15:16:06)
ACTION: - we need to
get involved in how filter/test docs are structured, how the
collection /docs folder works, how roles documenttion will work..
many seats... many tables(samccann,
15:20:15)
would like the collection index to have
collection defined: Summary section, auto generated plugin index,
links to static content section.(abadger1999,
15:32:13)
we should put collection name and collection
version onto the collection index page (regardless of how the rest
of the page is structured)(abadger1999,
15:34:27)
see how puppet does some of this
https://forge.puppet.com/modules/puppetlabs/stdlib - with tabs for
changelogs, example foler from github etc(samccann,
15:34:47)
ACTION: abadger1999
to do a slight mockup of what a new collectoin page could look
like(samccann,
15:38:09)
please provide feedback by Dec 3 on Separating
Ansible 3.0.0 collection docs from ansible-core -
https://hackmd.io/TQmzyhCUSSKa22iFR_079A?both(samccann,
16:00:50)
No supplementary meeting on Nov. 26, since it's
Thanksgiving Day for the US-based docs team(acozine,
16:01:43)
samccann ask galaxy team what they render today - md/rst and if they look at all in the /docs folder
- we need to get involved in how filter/test docs are structured, how the collection /docs folder works, how roles documenttion will work.. many seats... many tables
abadger1999 to do a slight mockup of what a new collectoin page could look like
Action items, by person
abadger1999
abadger1999 to do a slight mockup of what a new collectoin page could look like
samccann
samccann ask galaxy team what they render today - md/rst and if they look at all in the /docs folder