augur icon indicating copy to clipboard operation
augur copied to clipboard

docs: add newcomer guide content and update CONTRIBUTING.md and index… #3442 #3445

Open iGufrankhan opened this issue 2 weeks ago • 2 comments

This PR adds newcomer onboarding content directly into CONTRIBUTING.md

The goal is to make the onboarding flow clearer and ensure new contributors see important guidance immediately.

This update includes:

  • A new "Your Journey from Newcomer to Confident Contributor" section
  • Visual guidance on how to find good first issues
  • Clarification on community meetings and Slack participation
  • Links to documentation relevant for onboarding
  • Minor updates to index.rst to keep documentation consistent

This PR fixes #3442.

Notes for Reviewers:

  • Changes are documentation-only; no code modifications.
  • Please let me know if you'd prefer this content in a different location within the file.
  • Screenshots are referenced using GitHub attachment links.

Signed Commits:

  • Yes, I signed my commits.

✨ Thank you for reviewing!

iGufrankhan avatar Dec 07 '25 06:12 iGufrankhan

@MoralCode image

if we want to maintain name in one place so i recommned to remove the contributiors.md beacauseThe index.rst page already documents this well, and it’s an important part of the documentation structure—as shown in the screenshot above

and for image can i make a file docs/static store the image there this would ensure the images stay in the repository and avoid broken links in the future. what do you think about this and I’ve also revised the CONTRIBUTING.md to be clearer, more aligned with the existing style, and better integrated with the current guidance

iGufrankhan avatar Dec 07 '25 19:12 iGufrankhan

@MoralCode image

is this good update the contributing.md in index.rst for the images I used — can I just upload them in this issue and reference the URLs? I think creating a new folder only for images isn’t necessary. What do you think?

iGufrankhan avatar Dec 08 '25 18:12 iGufrankhan