symposion icon indicating copy to clipboard operation
symposion copied to clipboard

Symposion, Pinax Project Symposion, PinaxCon Docs

Open KatherineMichel opened this issue 10 years ago • 3 comments

Hi, I'm creating an issue for contributing to Pinax Symposion docs. I brought this up in Slack on Feb 29. I offered to help document PinaxCon, but also noticed pinax-project-symposion after that and could help with this at the same time. The Symposion Docs seems like the logical place to document this...? Here is a possible new structure for the index.rst

.. toctree:: :maxdepth: 2 :caption: Symposion Apps

project conference content proposals sponsorship speakers schedule

.. toctree:: :maxdepth: 2 :caption: Starter Projects

pinax-project-symposion pinaxcon

.. toctree:: :maxdepth: 2 :caption: Examples

I got the caption info from here: http://www.sphinx-doc.org/en/stable/markup/toctree.html#toctree-directive

The new detail pages would be something like: pinax-project-symposion pinaxcon

The examples part could either be a hyperlink directly to project (DjangoCon, PyCon website repos, ect) or a detail page for each project to give more explanation and hyperlink... ?

These are just my initial thoughts, btw. Could be changed, but it is similar in format to https://github.com/pinax/pinax/blob/master/docs/index.md though. Does anyone else have any thoughts?

Update, March 12: I also just discovered that there are docs for PyCon, based on Pinax Symposion. This could also be somehow referenced.... https://pycon.readthedocs.org/en/latest/

KatherineMichel avatar Mar 04 '16 19:03 KatherineMichel

This looks great @KatherineMichel! Thank you! @jtauber Any thoughts/comments?

ossanna16 avatar Mar 07 '16 20:03 ossanna16

Thanks! They have a lot of issues going on, so if it takes some time, it's ok. :)

KatherineMichel avatar Mar 07 '16 20:03 KatherineMichel

Thank you for being patient! :)

ossanna16 avatar Mar 07 '16 20:03 ossanna16