Pulp

This will take the place of the Promotion stub. s/Promotion/Lifecycle/
https://docs.pulpproject.org/en/3.0/nightly/workflows/promotion.html

This story will address 2 areas.

Workflow:¶

("workflows" might get renamed)

remind user to check plugin docs first
This section should *clearly indicate that the lifecycle workflow is the **common case, and is intended to supplement plugin documentation. Users should consult their plugin docs first to make sure this workflow applies to them.

explain the why
Lifecycling in Pulp uses the Distribution Object (Link to Distribution REST API) to host publications at a namespace controlled by the user. This is a powerful tool and is intended to allow flexible workflows. 2 examples:

1. "promote" from dev->testing->prod for example.
2. Rollback to previous publications

REST API autodocs¶

Improve the clarity of the help_text for each field on a distribution, try to use the language of the lifecycling workflow, and include a link.
Autodistribution should be covered in the help_text for publisher/repository. (was https://pulp.plan.io/issues/3392)

This is referenced here https://docs.pulpproject.org/pulpcore/workflows/promotion.html?highlight=base_version