[📑 Docs]: Consolidate onboarding and contribution pages to reduce duplication

[CBID2]

What Dev Docs changes are you proposing?

As highlighted in #2204, the current onboarding experience is fragmented and does not provide a clear path for new contributors.

The following pages are currently under construction or overlapping in purpose:

• How to Contribute
• Where to Contribute
• Documentarian Onboarding Guide
• Onboarding Introduction

This separation creates:

• No clear starting point for new contributors
• Fragmentation between how and where to contribute
• Potential duplication or inconsistency across pages

---

Proposed Solution

This proposal builds on the onboarding challenges described in #2204 and aligns with documentation improvements discussed in #1650, particularly around reducing duplication and improving structure.

1. Create a unified Contributing Guide

Merge:

• “How to Contribute”
• “Where to Contribute”

Into a single page with clear sections:

• How to contribute (process, steps, workflow)
• Where to contribute (platforms, repositories, areas of contribution)

2. Simplify onboarding content

• Move essential parts of the Technical Writer Contributor Responsibilities into the main Documentarian Onboarding Guide page
• Add a dedicated section:
  • Getting Started for Documentarians

3. Improve navigation

• Replace redundant standalone pages with anchor links
• Ensure each section has a single source of truth
• Cross-link related sections instead of duplicating content

---

Benefits

• Streamlined onboarding experience for new contributors
• Reduced duplication and easier long-term maintenance
• Improved clarity and navigation across documentation
• Better alignment with existing documentation improvement efforts ([📑 Docs]: Reorganize documents in the community repo #1650)

---

Code of Conduct

• I agree to follow this project's Code of Conduct

Are you willing to work on this issue?

Yes, I am willing to submit a PR!

[bandantonio]

@CBID2 You may want to check #1650 for more context on what content we were expecting to add to these pages.

[ksaini-web]

Hi! I’ve worked on this and opened a PR for it: #3506

In this PR, I combined the “How to Contribute” and “Where to Contribute” pages into a single Contributing Guide and added a redirect to avoid duplication.

Would really appreciate your feedback 🙂

[CBID2]

Hi! I’ve worked on this and opened a PR for it: #3506

In this PR, I combined the “How to Contribute” and “Where to Contribute” pages into a single Contributing Guide and added a redirect to avoid duplication.

Would really appreciate your feedback 🙂

Thanks @ksaini-web. But did you get onboarded before making the PR?