-
Notifications
You must be signed in to change notification settings - Fork 24
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
doc feedback #568
doc feedback #568
Conversation
(For info it's not needed to backport this PR, it can be merged just in main) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for making these updates Joel. I'm glad it doesn't need to be backported 😅 lgtm!
Edit: It seems like no one is sure and some people are saying they don't get PM approval for GitHub links in autogenerated APIs so, I guess to heck with the contributing guidelines warning against it 😆 just keep the GitHub link. Sorry for worrying you. I think I've had too many sweaty discussions with Eric Rich about including GitHub links 😅 Second edit: with Slack consensus from interested parties on the docs team, I'm opening a PR to modify our contributing guidelines to make an exception for github links in autogenerated API docs: openshift/openshift-docs#71592 For the GitHub link: openshift/openshift-docs#71033 (comment), since the style of product docs doesn't really play nicely for the upstream documentation, I can amend the link in the product doc version only. Otherwise, I'm double checking with the docs team about this issue. I feel its a really good example for why we need to be able to put links in modules. It sucks because we literally have this same reference replicated in product docs but we can't create a proper link :( |
/retest |
@skrthomas thanks! |
@jotak: The following test failed, say
Full PR test history. Your PR dashboard. Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository. I understand the commands that are listed here. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM!
/approve |
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: jotak 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 |
5e97123
into
netobserv:main
@skrthomas FYI
cc @memodi @nathan-weinberg