jenkins-infra / jenkins.io

A static site for the Jenkins automation server
https://jenkins.io
Other
312 stars 1.18k forks source link

Pipeline steps doc generator is missing the `build` step #7273

Open MarkEWaite opened 2 months ago

MarkEWaite commented 2 months ago

Describe your use-case which is not covered by existing documentation.

The Pipeline build step page has previously included a description of the build step that a Pipeline can use to run another job. That description is no longer visible in the page.

Today's page

screencapture-jenkins-io-doc-pipeline-steps-pipeline-build-step-2024-04-26-08_22_34-edit

What it should include

The page should include the online help for the build step that is available from within the Pipeline syntax snippet generator of a running Jenkins controller. On my controller, it looks like this:

screencapture-mark-pc2-markwaite-net-8080-job-Pipeline-from-scm-pipeline-syntax-2024-04-26-08_18_30-edit

Reference any relevant documentation, other materials or issues/pull requests that can be used for inspiration.

Issue first reported in the Jenkins documentation feedback sheet, row 1561.

kmartens27 commented 2 months ago

After doing a bit of digging, it appears that the build step content was still present on February 29 2024 but gone by March 14 2024. According to the repo, the last commit/PR was at the end of January 2024, so nothing obvious about removing the content since that time.

MarkEWaite commented 2 months ago

After doing a bit of digging, it appears that the build step content was still present on February 29 2024 but gone by March 14 2024. According to the repo, the last commit/PR was at the end of January 2024, so nothing obvious about removing the content since that time.

Thanks very much for the investigation. We'll need to bisect the pipeline steps doc generator output to identify when the change happened and then further research to identify if that was a change in the documentation of the plugin or a change in some other component.