Create a Cookieplone entry in the Conceptual guide

[stevepiercy]

Links of affected pages in Plone Documentation, if any.

Conceptual guides

Description

Plone documentation uses "conceptual guide" as a synonym for "explanation", as defined in the Diátaxis framework.

Cookieplone is not well understood by the broader Plone developer community. A conceptual guide for Cookieplone could include:

• A diagram of the workflow, from running Cookieplone to generate a project, to project installation, to project development, documentation, project deployment and management, and beyond. Plone Documentation supports both Mermaid and Graphviz formats. Source code for generating a diagram must be included, and exported as SVG.
• Describe all the tools that come with a Cookieplone project, especially those in devops and documentation.
• Cull information from https://training.plone.org/plone-deployment/ as needed.
• Other?

[Piyush-t24]

Hi Steve,

I’ve compiled a guide on how Cookieplone works, based on my research, and attached the PDF for your review. Could you please check if the information is helpful and let me know if any changes are needed?

Also, I’m interested in contributing to the codebase. Do you think this guide is a good starting point, or are there specific areas I should focus on?

Cookieplone guide.pdf

[stevepiercy]

@Piyush-t24 I think it's merely recycled material from Cookieplone's readme and not useful in this context. I updated the issue description to clarify a few things and set expectations.

I don't know the best place for you to start. I enjoy writing docs. I'd suggest starting wherever your interests may lay.

I recommend that you read and follow First-time contributors and Contributing to Plone as your entry points. I wrote them, so of course I'm biased.

[DeekshaVarshney123]

I have reviewed all the linked issues and understand the need for a detailed conceptual guide, workflow diagram, and updated tool descriptions for Cookieplone, including clarifying the role of github_organization and container_registry. I am starting work on this issue now and will submit a PR with the proposed content and diagram source code for review.