Carol Willing - Practical Sphinx - PyCon 2018

[@ZhihengLin]

5:00 Basics: install sphinx, create a project, file structures, build and serve 8:22 Words: source format (reStructuredText, Markdown, Notebooks, pandoc), content first, quality latter, spelling check tools 13:50 Visuals: images, directives (warning, see also, code, etc.) 15:43 Structure: toctree, caption 17:00 Workflow: testing, automate, host, monitoring, feedback 19:43 Extensions: autodoc, generating documentation by docs strings 22:00 Sphinx, JavaScript and Beautiful Design: pros of Sphinx, communities, comparison with JavaScripts tools, themes, customization

[@hardikvasa6445]

Excellent. Best starting guide on Sphinx.

[@mvaliente2001]

Excellent presentation! Direct, useful and to the point!

[@WaylonWalker]

Talk starts @ 3:00 for those watching

[@Bhuyakasha]

>>for those watching... as opposed to those not watching?

[@dullbananas9901]

thank you

[@arthurcgusmao]

Thanks, Carol, this was a really great presentation.

[@TeazaneOwlong]

Very great presentation ! Now everything seems clear enough to add Sphinx to my projects !

[@varenneriocha8712]

Oh, that was marvelous. Thanks a lot!

[@AnthonyMartinTech]

Carol gives a great talk that's easy to follow and one of the most important things to me does not add unnecessary fluff.

[@davidm.johnston8994]

Thank you for this talk!

[@dom1310df]

I tried using nbsphinx earlier this year. It was such a pain I wish I'd just written everything twice.

[@juliocardenas4485]

GREAT !!

[@kamalabuhenamostafa]

Carol, you have a nice Story telling Voice, Impressing.