docs: add explicit project links to contributing index (#7278)#9493
docs: add explicit project links to contributing index (#7278)#9493LoveChauhan-18 wants to merge 3 commits intoopen-telemetry:mainfrom
Conversation
| ## What can I contribute to? | ||
|
|
||
| OpenTelemetry documentation contributors: | ||
| If you want to contribute to the core OpenTelemetry projects, here is a list of the main repositories: |
There was a problem hiding this comment.
I feel we can discuss this further before merging, as per @svrnm's comment. Personally, I also like the idea of keeping this section clean and focused on documentation contributions.
Instead, we could expand the contribution possibilities by creating a new page/section (maybe /community/contribute?) that includes this list, the overall guidelines, and other content that is currently available only through the community repo. WDYT?
/cc @open-telemetry/docs-approvers
There was a problem hiding this comment.
I don't think this should be added here. There are even more repos that were mentioned here, so this could make it sound the missing ones are not "worth it", which is not true. Also, new repos are being created every now and then and keeping this up to date could be challenging. One option would be to link to the github page that list all otel repos, keeping it generic, and mentioning each one has a tab for "contributing" and more specific details can be found on them
Fixes #7278
This PR updates the "What can I contribute to?" section in the contributing _index.md to directly list the main OpenTelemetry repositories (Specification, Semantic Conventions, Collector, and Language SDKs).
Previously, users had to dig through the general community repo or specs to find where to contribute (like the
semconvdocs). This change surfaces the specific repository links right in the navigation, making them much easier to discover for new contributors.Footnotes
Yes, I can answer maintainer questions about the content of this PR, without using AI. ↩