Skip to content

[docs] Trim README "What is Augur?" section#3720

Open
devs6186 wants to merge 1 commit intochaoss:mainfrom
devs6186:docs/3703-trim-readme-what-is-augur
Open

[docs] Trim README "What is Augur?" section#3720
devs6186 wants to merge 1 commit intochaoss:mainfrom
devs6186:docs/3703-trim-readme-what-is-augur

Conversation

@devs6186
Copy link

Changeset

  • Replaced the multi-paragraph "What is Augur?" block in README.md with a 2-sentence summary and a link to the full readthedocs page

Notes

The section was duplicating content that already lives in the readthedocs "what is augur" page which was recently updated. The README is already quite long, so trimming this down makes it easier to find the actually important quick-start info. The link keeps the detailed version accessible.

Related issues/PRs

Description

  • Shortened the "What is Augur?" README section to 2 sentences + readthedocs link to avoid duplication

This PR fixes #3703

Notes for Reviewers
Simple content change — just removes duplicate prose and points to the canonical docs page.

Signed commits

  • Yes, I signed my commits.

…docs link

The section was duplicating content that already lives in readthedocs.
Replaced it with a 2-sentence summary and a pointer to the full docs.

Fixes chaoss#3703

Signed-off-by: devs6186 <devyanshsomvanshi@gmail.com>
@devs6186 devs6186 requested a review from sgoggins as a code owner February 19, 2026 16:34
@MoralCode MoralCode added the stale Stuff that's abandoned or not making forward progress and may need taking over/reassignment/closing label Feb 19, 2026
Copy link
Contributor

@MoralCode MoralCode left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall happy with this content

metrics are implementations of the metrics defined by our awesome community. You can find a full list of them [here](https://chaoss.community/metrics/).

For more information on [how to get involved on the CHAOSS website](https://chaoss.community/participate/).
Augur is a software suite for collecting and measuring structured data about free and open-source software (FOSS) communities. It gathers data from Git logs, GitHub, and other sources, normalizes it into a shared data model, and exposes health and sustainability metrics via a REST API. For a full overview, see the [Augur documentation](https://oss-augur.readthedocs.io/en/main/).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would like to see this linking to the "What is augur"/about augur" page one it is moved to the correct place. But overall im happy with the content change

@MoralCode MoralCode assigned MoralCode and unassigned MoralCode Feb 24, 2026
@MoralCode MoralCode added the documentation Updates documentation label Feb 24, 2026
@MoralCode
Copy link
Contributor

I have assigned this to @nancywrites.

What this needs to merge:

@MoralCode MoralCode added waiting This change is waiting for some other changes to land first and removed stale Stuff that's abandoned or not making forward progress and may need taking over/reassignment/closing labels Feb 24, 2026
Copy link
Contributor

@MoralCode MoralCode left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall happy with this content. Just waiting to link it to the dedicated What is augur ReadTheDocs page

@MoralCode
Copy link
Contributor

oops, didnt mean to resubmit that

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Updates documentation waiting This change is waiting for some other changes to land first

Projects

None yet

Development

Successfully merging this pull request may close these issues.

"what is augur" content duplicated in README and readthedocs

2 participants