-
Notifications
You must be signed in to change notification settings - Fork 5
Description
Which topic are you reporting about?
https://cloud.ibm.com/docs/devsecops?topic=devsecops-cd-devsecops-pipelines-custom-customize
What do you think needs to be updated?
Section "Configuration parameters" on that page starts describing the parameters within a stage without stating that these are the parameters within a stage. The sentence "The configuration in the .pipeline-config.yaml file supports the following parameters:" sounds like these are global parameters in the file and does not mention that these are parameters within each stage.
Second, that section also completely misses describing the different supported stages. It has a table showing "Pipeline" and "Stages" as column headings that lists some names of stages. The purpose of these stages is not described on that page, and the set of stage names also differs from the stages listed on https://cloud.ibm.com/docs/devsecops?topic=devsecops-cd-devsecops-apps-byoa.
Third, the meaning of stages listed in that table is not made clear. Are these the required stages for each type of pipeline and others are optional? Or the set of supported stages and others are not allowed? That should be clarified in a description of what the table shows.
Anything else?
No response