Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

📖 Use full URL for contrib source paths #6090

Merged
merged 1 commit into from
Feb 9, 2022

Conversation

stmcginnis
Copy link
Contributor

What this PR does / why we need it:

In the CONTRIBUTING file, there is a section on the Contributors
Ladder
that lists the sub areas with the cluster-api project. These
link out to the source for each area.

When viewing the CONTRIBUTING.md file via GitHub, these links work great
because they are relative to that file. But this file also gets pulled
in to the published Cluster-API book. When viewed from this
location, these links will try to go to relative paths within the book,
which do not exist.

To address this, this changes the link targets to the full GitHub URL to
the source code so that it works as expected in both the GitHub and book
rendering of the content.

In the CONTRIBUTING file, there is a section on the *Contributors
Ladder* that lists the sub areas with the cluster-api project. These
link out to the source for each area.

When viewing the CONTRIBUTING.md file via GitHub, these links work great
because they are relative to that file. But this file also gets pulled
in to the published Cluster-API book [0]. When viewed from this
location, these links will try to go to relative paths within the book,
which do not exist.

To address this, this changes the link targets to the full GitHub URL to
the source code so that it works as expected in both the GitHub and book
rendering of the content.

[0] https://cluster-api.sigs.k8s.io/contributing#contributors-ladder

Signed-off-by: Sean McGinnis <[email protected]>
@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Feb 9, 2022
@sbueringer
Copy link
Member

Thank you!

Small downside is that those links are not versioned, but I think it's definitely better than the current broken links

@sbueringer
Copy link
Member

Forgot
/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Feb 9, 2022
Copy link
Member

@neolit123 neolit123 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

--

@neolit123
Copy link
Member

/approve

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: neolit123

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Feb 9, 2022
@k8s-ci-robot k8s-ci-robot merged commit 88b5a8e into kubernetes-sigs:main Feb 9, 2022
@k8s-ci-robot k8s-ci-robot added this to the v1.2 milestone Feb 9, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. lgtm "Looks good to me", indicates that a PR is ready to be merged. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants