Should documentation be included in 6.docs.plone.org?

[stevepiercy]

If the docs should be included in 6.docs.plone.org, then we need to decide whether to keep them in this repo or move them into plone/documentation. They would also need to be overhauled and converted.

• bobtemplates plone  documentation#988
• Create Development guide as a primary navigation item and entry point documentation#1731
• https://github.com/plone/bobtemplates.plone/issues?q=is%3Aissue+is%3Aopen+docs

[MrTango]

I have no strong opinion on this, but don't see the urgent need to spend energy here.
We have enough more important things to do.
Right now the docs are available here and on read the docs.
We can link them from the Plone docs and from plonecli which is more referenced in Plone docs.

[stevepiercy]

The Alabaster theme is 💩. It is worse than Basic theme.

I'd like to use Plone Sphinx Theme on it, now that it is ready for general use. A consistent brand and identity is a Good Thing™.

If that doesn't work, then RTD Theme is fine.

Then we can link to it from wherever bobtemplate.plone is mentioned in the primary docs.

@MrTango can you send me an invite to maintain https://app.readthedocs.org/projects/bobtemplatesplone/ ?. I can also set up pull request previews and other shiny things.

[MrTango]

Is can maintain enough or do you need administrator?

[stevepiercy]

RTD has only the one role, maintainer. My RTD username is stevepiercy.

I'd also suggest adding one other trusted person, to avoid the hit by a bus scenario. Who else maintains bobtemplates?

[MrTango]

I added you and @erral as maintainers.