Release Plone 6 docs

[stevepiercy]

This is a placeholder issue for the imminent release of Plone 6 docs as being tracked in the GitHub Project Board Plone 6.0 - tasks to final.

Documentation project board: https://github.com/orgs/plone/projects/12/

Preview current state of Plone 6 documentation (branch 6-dev): https://6.dev-docs.plone.org/

Organization

Discord server

https://discord.gg/NES2f6dQ Channel: #training-docs

List the principals and their roles for this issue.

GitHub username	Roles
@ericof	Automation
@ksuess
@pbauer	Training
@polyester
@sneridagh	Volto docs
@spereverde	general structuring/writing docs
@stevepiercy	Lead cat herder
@svx
@tkimnguyen	happy to help, but no specific idea where to start yet
@MrTango	Classic UI / Backend
@flipmcf	Gopher
Insert Your Name Here

Features and Automation

• [x] Automate testing of docs on each pull request
• [x] https://github.com/plone/documentation/issues/1146
• [x] #1154
• [x] Spell checking
• [x] Link checking
• [x] #1149
• [x] Makefile
• [x] Filter search results by primary section, other?
• [x] #1156
• [x] Page titles show chapter title - sub-chapter title - Plone Documentation
• [ ] #1147
• [x] TOC is sticky (always displays while scrolling), and may be collapsed or hidden
• [x] Code can be copied with a click
• [x] Glossary
• [x] Automatically generated index

Which tech stack?

• Sphinx and MyST: Supports reStructuredText and a superset of CommonMark markdown. Used by Training docs.
• Current: hell no.
• Coster: seems to have disappeared.
• Docusaurus: new to developers, lacks features that Sphinx provides OOTB.
• [X] Determined that we shall use MyST and Sphinx for our tech stack.

Branches

• [X] Create 6-dev. This is the feature branch where development for Plone 6 Docs occurs.
• 6 is the main release branch for Plone 6 Docs.
• [X] Merge backend-6 into 6-dev.
• [X] Merge classic-ui into 6-dev.
• [X] Delete volto-frontend as there is nothing of value in it.
• [x] #1148

Structure

• See #1137
• [x] Create a table of contents for each primary item, keeping it as shallow as possible.

Theme

• [x] Select and use a mobile friendly theme, preferably one that unifies Plone, Training, and Volto docs, giving users a coherent experience.
• [x] #1150

Content

• [x] #1151
• Create instructions for how to:
  • [x] write new docs as an Author or Developer
  • [x] contribute to existing docs as a Contributor
• [ ] #1152
• [x] #1153

See https://github.com/plone/training/issues/254#issuecomment-991855153

[ksuess]

Summary of the sprint meeting 15.02.2022 14 CET Present: @polyester @sneridagh @rioksane and plone.org sprint participants.

Paul summed it up already in Discord:

• use the same tech stack as training
• use only one branch, for both classic and volto
• use markdown as the language
• bring them online, automated, under something like https://6-dev.docs.plone.org/
• start working, refine later.

My opinion

• on branches: One branch to have one point to continue with contributing. Be clear to the plurality of potential contiributors where to drop changes, additons, continue writing. I think this is what attracts more contributors.

I can setup a merged branch "6-dev" with all new already written docs for Plone 6. [New merged working branch set up : https://github.com/plone/documentation/tree/6-dev] @ericof Could you set up a subdomain 6-dev.docs.plone.org and the deployment of the branch "6-dev". @stevepiercy It's a pitty that we set up the meeting on time that's not yours. Do you want to continue with setting up Sphinx, theme, Makefile, checkers, etc. on branch "6-dev"? @polyester wants to enhance the set up with guide lines and editor configuration for a political correct language and more.

[ksuess]

Project for involved issues: https://github.com/orgs/plone/projects/12/

[MrTango]

Regarding the structure, we started here with defining how we would see backend and classic-ui being structured, so that we have backend which is for headless and classicc-ui and the classic-ui topics. Volto-ui will be the 3. category and probably pointing to backend topics. https://github.com/plone/documentation/issues/1137

[stevepiercy]

I have locked conversation on this issue because I created separate issues for each of the remaining tasks that is not in PR #1141. I will keep it open as a reference.