Pipeline: SCM Step page - GitSCM docs require an extra click

[kwilson33]

Problem with the Pipeline: SCM Step page

The page is missing the dropdown menu for the GitSCM class. A few months ago from today (2/7/23) I remember there being one, showing all of the options. Now, there is just an 'scmGit' drop-down that is empty.

Screenshots

Empty 'scmGit' dropdown

Possible Solution

Add documentation for the scmGit/GitSCM class.

N/A

[MarkEWaite]

The scmGit page has been deduplicated from the many, many locations where it was inserted and placed in its own page. That dramatically improved page load time and made the pages much more usable. It also changed the interaction with that link. It now requires a two step process to reach the scmGit documentation.

When the page first opens, that region looks like this:

1. Click the "+" to the left as scmGit as though you were expanding it. The word scmGit is then converted from a text string into a hyperlink. That results in something that looks like this:

2. Click the scmGit hyperlink to navigate to the scmGit page. That opens a page that has this:

I'm sure that there is more that can be done to improve the navigation beyond the current two step process. The page load time performance from the GSoC 2022 project were so significant that we accepted this additional step in order to read the scmGit page.

[kwilson33]

Oh wow I don't know how I didn't realize that there was a hyperlink, thanks!
My main issue was that I couldn't find the scmGit documentation, so now that I can view it, I'm relieved.
Though, I do agree that the 2 step process could probably be improved.

[MarkEWaite]

I'd love to have someone improve that interaction, but I'm not the person to do it. No JavaScript skills and no real interest in developing them.

[kwilson33]

Understood. Not a big deal 😊.

Related question, and I think you'd be able to help.
What is the most up to date page on GitSCM/scmGit?

I see there are these 2 pages

• https://www.jenkins.io/doc/pipeline/steps/params/scmgit/
  • Linked to from https://www.jenkins.io/doc/pipeline/steps/workflow-scm-step/
• https://www.jenkins.io/doc/pipeline/steps/params/gitscm/
  • Possibly a leftover page?

Both have similar content, and I believe are documenting the same functionality.

Maybe this should be opened up in another issue?

[MarkEWaite]

Both have similar content, and I believe are documenting the same functionality.

https://www.jenkins.io/doc/pipeline/steps/params/scmgit/ is the most current page.

Already opened as an issue in:

• Ensure removed jenkins.io pages aren't accessible and indexed anymore helpdesk#3360

[lemeurherve]

Since #6677 these outdated pages return (for now at least) a 403 error, see jenkins-infra/helpdesk#3360 (comment)