Skip to content

Add Generic Setup term in Glossary #1896

Closed
@acsr

Description

@acsr

The term is used but not explained or covered in the Plone 6 Documentation except to be mentioned in the Upgrade Docs and Glossary descriptions.

Challenge

You cannot figure out easily in the Plone 6 Docs if the Generic Setup technology is still relevant for setting up a modern Volto based Plone Setup, which it in fact it is.
Especially for configuring ClassicUI features still relevant but not configureable TTW via Volto.

Example:

Portal Actions as term is only mentioned in the Plone 6 Docs for the backend and the API:
Portal Actions are touched here
https://6.docs.plone.org/backend/portal-actions.html (ZMI or ClassicUI)
https://6.docs.plone.org/plone.restapi/docs/source/endpoints/actions.html (API)

It is difficult to get a clue that this needs knowledge of Generic Setup and where to look up.

Benefit of adding terms not yet covered in the docs

The Glossary is a good starting point to be found in the docs even if not covered there.
You can safely point to older docs or related terms to catch up (like CMF Action)

Related: Point to the location in the developer stack

I would like to have some visualisation of topics in context similar to:

I would not clutter the docs with the imagery bit offer it on hover or via toggles.

One last related thing

If there is a policy what to cover in the glossary or not, I simply ignored that.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions