Repository: kubernetes
Issue: kubernetes/client-go:.github/PULL_REQUEST_TEMPLATE.md is unhelpful plus suggestion about SIG labelling
Labels: sig/contributor-experience,kind/feature,needs-triage

### What happened?

Drafting a PR to the [kubernetes/client-go repo](https://github.com/kubernetes/client-go) results in an unhelpful message with prose, but, no links, and the referenced content is a number of indirections away from anything remotely helpful.

### What did you expect to happen?

The contents of the pr template should include links to relevant and helpful files. -- The `README.md` text should be a link to the master/HEAD file (this won't hurt someone who decides to edit the readme file in the repository or has already done so), and a reference to contributing should be a link to something that's useful and doesn't require following multiple links to get to an actual contributing file with useful information.

### How can we reproduce it (as minimally and precisely as possible)?

1. do the work to construct a code commit for a repository
2. prepare to create a PR: https://github.com/kubernetes/client-go/compare/master...jsoref:client-go:issue-1321?expand=1
3. read the message
4. Note that `README.md` and `CONTRIBUTING.md` aren't links to anything which means you now have to go back **x** pages just to try to find them
5. Assuming you've decided that the `README.md` isn't applicable, you now have to browse to (many steps, especially if you didn't start in the repository itself, which you won't in most cases, e.g. here, ...) and open [`CONTRIBUTING.md`](https://github.com/kubernetes/client-go/blob/master/CONTRIBUTING.md)
6. Read that text and realize that there was no need for the previous document to reference it -- the relevant text could have been inlined and the reference could have been to "the same [contributing guide](https://git.k8s.io/kubernetes/CONTRIBUTING.md)"
7. Open https://git.k8s.io/kubernetes/CONTRIBUTING.md
8. Read that even shorter text and realize that it too was a waste of reading (if you haven't gotten frustrated yet, you're doing way better than a newcomer, please let go of your prior knowledge, slow down, and recognize that all of these links and pages are actually frustrating)
9. Get to "check out the [Contributor's Guide](https://git.k8s.io/community/contributors/guide/)" and sigh.
10. Follow another link to another "Contributor's Guide" (https://github.com/kubernetes/community/tree/master/contributors/guide
11. Note that this one randomly dumped you into a directory instead of an _anything_, so you'll probably have to scroll past all of the files to get to the readme -- if you haven't asked "why is this happening", you're using too much experience -- take a break, come back pretending that you don't know much about k8s and do understand that links **can** and **should** take you somewhere useful instead of dumping you into a [gopher menu](https://en.wikipedia.org/wiki/Gopher_(protocol)) from 1991. 
12. Scroll down to https://github.com/kubernetes/community/tree/master/contributors/guide#readme
13. Read some metadata
14. Scroll down to https://github.com/kubernetes/community/tree/master/contributors/guide#getting-started
15. Read a ToC
16. Scroll down to https://github.com/kubernetes/community/tree/master/contributors/guide#contributor-guide
17. follow the instructions in the `Contributor Guide` section which instruct you to read "this page" (which is not really where you are -- you're actually in a directory)
18. Get annoyed at some of the prerequisites because they aren't really relevant -- and they also aren't even logical. [A bot](https://github.com/k8s-ci-robot) is not going to check to see if you have a GitHub account because you can't get to the bot until you have one.
19. The link for [a bot](https://github.com/k8s-ci-robot) does not explain what it does because there is no [k8s-ci-robot/k8s-ci-robot repo](https://github.com/k8s-ci-robot/k8s-ci-robot) to show a pretty message explaining what the bot does -- which means if you click the link that is provided you'll be dumped somewhere useless.
20. Assuming you were dumped somewhere useless and saw the pretty little graph of how busy this beaver is:
    <img width="1142" alt="image" src="https://github.com/kubernetes/kubernetes/assets/2119212/3eab0ad8-0213-43b3-8fbc-1caaf1901f4d">
21. If you try really really hard and squint, you might find: https://github.com/kubernetes/test-infra/tree/master/prow#bots-home
22. Click that link to https://github.com/kubernetes/test-infra/tree/master/prow#bots-home
23. And get dumped in another gopher style directory listing,.
24. Scroll down to the bottom of the window to see:
25. "DOCUMENTATION DEPRECATION NOTICE: This file is deprecated."
26. Sigh and go back a couple of frames -- your choose your own adventure is going to sap a lot of years from your life (you'd be better served watching [The Princess Bride](https://en.wikipedia.org/wiki/The_Princess_Bride_(film))
27. Now where were we? [Lost in a maze of twisty passages, all alike?](https://en.wikipedia.org/wiki/Colossal_Cave_Adventure#:~:text=The%20phrase%20%22you%20are%20in,does%20not%20change%20the%20result.), ah, yes.
28. We were trying to figure out how to contribute.
29. Well, we've gotten to https://github.com/kubernetes/community/tree/master/contributors/guide#community-expectations-and-roles
30. Go read [Community Expectations](https://github.com/kubernetes/community/blob/master/contributors/guide/expectations.md) -- it isn't helpful -- this stuff will not help you make an initial contribution and is not what you as a new contributor would expect from an item labeled "Community Expectations".
31. See [Community Membership](https://github.com/kubernetes/community/blob/master/community-membership.md) -- this is also *really* not *remotely* helpful to someone looking to make an initial contribution.
32. Scroll down to https://github.com/kubernetes/community/tree/master/contributors/guide#kubernetes-contributor-playground
33. There's a [Kubernetes Contributor Playground](https://github.com/kubernetes-sigs/contributor-playground/blob/master/README.md)
34. Follow the link.
35. A [Youtube playlist](https://www.youtube.com/playlist?list=PL69nYSiGNLP3M5X7stuD7N4r3uP2PZQUx)
36. Note that `YouTube` is misspelled on this page as well as on the previous page -- apparently respect for other brands isn't a community value (this does appear to be the case, remember if you read https://github.com/kubernetes/community/blob/master/values.md#community-over-product-or-company that the "value" is "Community over product or company")
37. You probably don't have time to watch the playlist (have you? do you?) -- I'm going to regret this, but, a quick check shows that it's probably well over a day log -- there are 6 items that are over an hour long each, and two that are 50+mins (and one that's nearly 50mins).
38. Well, that was a good time sink. Let's go back and try to get to the end of that first guide -- remember you're already 2 links away from where you started and haven't learned anything about what you were trying to do (which is figure out what you actually *need* to do to make a PR -- which is probably understanding what labels you'll need to suggest to the bot or whether you can safely ignore the bot's insistence that you provide labels that you don't understand and can't determine on your own because you are in fact a *new* contributor).
39. Ok, so there was a readme in https://github.com/kubernetes-sigs/contributor-playground/blob/master/README.md and it was confusing -- what's the "New Contributor Onboarding Track" and why isn't it a link to something? 
40. "A [Youtube playlist](https://www.youtube.com/playlist?list=PL69nYSiGNLP3M5X7stuD7N4r3uP2PZQUx) of the New Contributor workshop has been posted, and an outline of content to videos can be found [here](http://git.k8s.io/community/events/2018/05-contributor-summit)." -- what does "has been posted" mean? has been posted _when_?
41. Why wasn't `remote` a link to something?
42. You leave the contributor playground with more questions than answers.
43. If you do manage to find [`remote`](https://github.com/kubernetes-sigs/contributor-playground/tree/master/remote) you'd discover it's from 2021 and has misbranded `youtube` differently (instead of `Youtube`)...
44. If you really decided to visit https://github.com/kubernetes-sigs/contributor-playground/pulls you'd discover that `area` and `sig` and all the things you might need to actually understand to actually contribute to [kubernetes/kubernetes](https://github.com/kubernetes/kubernetes) are absent.
45. Scroll down to https://github.com/kubernetes/community/tree/master/contributors/guide#contributor-workshops
46. Is this another reference to the *same* youtube playlist as on the previous page? or not? do you dare click on it? I do not dare you to. I do not dare click on it.
47. Scroll down to https://github.com/kubernetes/community/tree/master/contributors/guide#community
48. There's a link to [Community Membership Document](https://github.com/kubernetes/community/blob/master/community-membership.md) is that the same as [Community Membership](https://github.com/kubernetes/community/blob/master/community-membership.md) from a few paragraphs above? Do you remember? If you cheat you'll discover it is, but you could ask "why is this link text different from that link text?" -- you should, but you're probably too exhausted by this point.
49. Scroll to https://github.com/kubernetes/community/tree/master/contributors/guide#communication
50. Follow the link to https://github.com/kubernetes/community/tree/master/communication? I wouldn't recommend it. Amusingly they spelled `YouTube` correctly. Unsurprisingly they did not write `Zoom` correctly.
51. There's a link to [Kubernetes code of conduct](https://github.com/kubernetes/community/blob/master/code-of-conduct.md) (which is not written with the proper case -- so you don't know if it's the same as other documents or not, it is, in fact, the whole text is silly as it's actually the CNCF CoC -- I believe that this issue falls well within that guidance).
52. Scroll to https://github.com/kubernetes/community/tree/master/contributors/guide#events and decide that the rest of the items here are not helpful.
53. Scroll to https://github.com/kubernetes/community/tree/master/contributors/guide#advanced-topics
54. "This section includes things that need to be documented, but typical contributors do not need to interact with regularly." -- great, this is clearly not something that you're supposed to read, it says so right there! -- They're right, even though one might hope that SIGs/AREAs/... are related to ownership, the referenced documentation will not help you as a new contributor figure out what to do.
55. There are other files in the directory. At this point it's time to give up. You recall somewhere that some page mentioned Slack -- I'd recommend trying to figure out how to get to slack and then getting lost trying to figure out which slack channel is appropriate for asking for help filing this report. -- This report filed at the behest of someone in a slack channel -- I would not have spent the time to do so without being asked to do so, this was a very expensive ticket.

### Anything else we need to know?

https://github.com/kubernetes/client-go/blob/master/.github/PULL_REQUEST_TEMPLATE.md

I understand that you don't want to maintain the repository itself, but by the time a user sees this message, they've already tried very hard to compose a PR, they shouldn't be forced to do many jumps of indirection and jump through many hoops to get to a place that tells them where to go.

If retaining a reference to `CONTRIBUTING.md` in the [kubernetes/client-go repo](https://github.com/kubernetes/client-go) is deemed essential, it should really be a link to https://github.com/kubernetes/client-go/blob/HEAD/CONTRIBUTING.md (if you're afraid that someday `master` will be replaced by `main`...) instead of just words -- if a user already tried to do a thing, giving them a message that requires them to take x steps instead of a path forward is really frustrating.
And that `CONTRIBUTING.md` confusingly (it has more words than the thing it) points to https://github.com/kubernetes/kubernetes/blob/master/CONTRIBUTING.md
which then points to **another** contributing guide: https://github.com/kubernetes/community/tree/master/contributors/guide


### Kubernetes version

N/A

### Cloud provider

N/A

### OS version

Web submission

### Install tools

_No response_

### Container runtime (CRI) and version (if applicable)

_No response_

### Related plugins (CNI, CSI, ...) and versions (if applicable)

_No response_