Transfer Plone Deprecation Guide?

[jensens]

Plone Documentation versions affected

• 5.x
• 6.x

Description

I would like to update and transfer the Plone Deprecation Guide to the new docs. But where would it fit?

It needs to be converted to MyST from its source https://github.com/plone/documentation/blob/5.2/develop/styleguide/deprecation.rst using rst-to-myst as described in https://6.docs.plone.org/contributing/documentation/admins.html#importing-external-docs-and-converting-to-myst.

[stevepiercy]

Good question.

We have not yet migrated the Develop docs from the 5.2 branch on plone/documentation.

buildout.coredev docs covers some of the same guidelines and policies.

I think before we take any action, we should take inventory of all the current docs that are policies or guidelines for contributing and developing, then figure out where all the bits will fall into place. I am on board to help determine the structure of these docs. Would you like to take the lead to come up with a plan?

References:

• buildout.coredev docs need to be pulled into Plone 6 Documentation buildout.coredev#840 discusses pulling plone/buildout.coredev docs into Documentation.
• Edit Contributing docs #1278 discusses overhauling Contributing to Plone.

[jensens]

Would you like to take the lead to come up with a plan?

Not now: time limitations. Also, I think first we should finish the current docs. But keep this on hold and come back later.

[stevepiercy]

With the merge of #1486, this issue can now be worked on. @jensens back to you!

[stevepiercy]

Following up on this. This guide is a combination of a Conceptual guide and a How-to guide, and it needs to be split into its two parts. For a definition of these two, see https://diataxis.fr/.

• New page under Conceptual guides
• New page under Developer guide Contribute to Plone 6 core. (Edited 2025-02-13, as we recently added this section, which is more appropriate for things beyond the backend.)

[MrTango]

solved by #1850

[MrTango]

We decided to put it directly in backend, as it is only backend related.