Skip to content

Clarify scmGit parameter for checkout Pipeline step - #1759

Merged
MarkEWaite merged 6 commits into
jenkinsci:masterfrom
MarkEWaite:more-links-in-docs
May 24, 2025
Merged

Clarify scmGit parameter for checkout Pipeline step#1759
MarkEWaite merged 6 commits into
jenkinsci:masterfrom
MarkEWaite:more-links-in-docs

Conversation

@MarkEWaite

Copy link
Copy Markdown
Contributor

Clarify scmGit parameter for checkout Pipeline step

The documentation for the scmGit parameter to the checkout step is not as immediately accessible from the checkout page as I would like. Readers have difficulty finding that documentation in the many other documentation links within the checkout step.

Add more links to the scmGit parameter documentation in hopes that readers will be more likely to find it.

Change also includes other minor documentation improvements like:

  • Link from extensions help to plugins help page
  • Use most recent Git LFS project link
  • Place id on the strong tag instead of a separate a tag
  • Fix syntax error in checkout example
  • More consistent spacing in examples

Testing done

Reviewed the formatting and content of the modified documentation pages from within a running Jenkins 2.511.

Confirmed that the newly added hyperlinks reach the correct location in the internal Pipeline steps reference page at /pipeline-syntax/html/

Confirmed that the Git LFS link works as expected.

Confirmed that the modified examples of the checkout step run as expected in Jenkins 2.511 with latest Pipeline plugins.

Submitter checklist

  • Make sure you are opening from a topic/feature/bugfix branch (right side) and not your main branch!
  • Ensure that the pull request title represents the desired changelog entry
  • Please describe what you did
  • Link to relevant issues in GitHub or Jira
  • Link to relevant pull requests, esp. upstream and downstream changes
  • Ensure you have provided tests that demonstrate the feature works or the issue is fixed

The extensions help content is included in the Pipeline steps reference
extensions section at:

https://www.jenkins.io/doc/pipeline/steps/params/scmgit/

The text in that location is brief and does not include screenshots.
Link to the more detailed description in the plugin documentation and
its related screenshots.
No need to redirect through github.com since the project now has its
own page.
Experiment to see if the links will be preserved in pipeline steps reference
@MarkEWaite MarkEWaite added the documentation Improvements or additions to documentation label May 24, 2025
@MarkEWaite
MarkEWaite requested a review from a team as a code owner May 24, 2025 15:43
@MarkEWaite MarkEWaite added the documentation Improvements or additions to documentation label May 24, 2025
@MarkEWaite
MarkEWaite merged commit 73a5a49 into jenkinsci:master May 24, 2025
@MarkEWaite
MarkEWaite deleted the more-links-in-docs branch May 24, 2025 17:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant