Skip to content

Commit 3793338

Browse files
committed
enhancement: use 3rd person
1 parent a1dee8d commit 3793338

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

docs/welcome/key-metrics-guide.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -10,53 +10,53 @@ keywords:
1010
- "Open Source metric guide"
1111
---
1212

13-
Welcome to the Key Metrics Guide, where we define the main metrics used on our platform to help you better understand them.
13+
Welcome to the Key Metrics Guide, where we define the main metrics used on our platform to help users better understand them.
1414

1515
## OSCR
1616

17-
[OSCR](../glossary/#oscr) stands for Open Source Contributor Rating. It's a way to measure and rate the impact of your open-source contributions over 90 days.
17+
[OSCR](../glossary/#oscr) stands for Open Source Contributor Rating. It is a way to measure and rate the impact of a user's open-source contributions over 90 days.
1818

19-
This helps you understand the quality and frequency of your contributions. It's a good way to measure your open source activities and takes into account many factors.
19+
This metric helps to determine the quality and frequency of a contributor's contributions. It is determined by their ability to engage in conversations about their work and the project, their rate of contributions to the projects they engage with, and the quality of their contributions.
2020

21-
You can read more about [what it is and how to improve it](../../opensauced-guides/oscr-score-guide/oscr-guide/).
21+
Read more about [what it is and how to improve it](../../opensauced-guides/oscr-score-guide/oscr-guide/).
2222

2323
## Contributor Confidence
2424

25-
[Contributor Confidence](../glossary/#contributor-confidence) is a metric that measures how likely contributors who have interacted with a repository via stars or forks are to contribute in some way. It's measured as a percentage calculated over a specified time range.
25+
[Contributor Confidence](../glossary/#contributor-confidence) is a metric that measures how likely users who have interacted with a repository via stars or forks are to contribute in some way. It is measured as a percentage calculated over a specified time range.
2626

27-
This helps you evaluate whether a repository you are interested in provides a good environment for new contributors. A positive score implies that the project is welcoming to new contributors or that those who interact with the project are willing to support the project through contributions.
27+
This helps potential users understand whether the project welcomes new contributors. A positive score implies that the project is welcoming, that contributions are likely to be accepted, and that participation in the community is nurtured.
2828

29-
You can read more about [what it is and how it can be interpreted](../../features/repo-pages/#insights-into-contributor-confidence).
29+
Read more about [what it is and how it can be interpreted](../../features/repo-pages/#insights-into-contributor-confidence).
3030

3131
## OpenSSF Score
3232

3333
[The OpenSSF Score](../glossary/#ossf-scorecard) is a metric that measures how secure an open-source project is based on how compliant the repository is to OpenSSF’s standards. It's scored out of 10 and uses [OpenSSF’s CLI tool](https://scorecard.dev/#what-is-openssf-scorecard) under the hood to help calculate this score.
3434

3535
[OpenSSF](https://openssf.org) refers to the Open Source Security Foundation, a group of security-focused tech professionals who are trying to enable the open-source ecosystem to create safe, open software in compliance with the [EU’s Cyber Resilience Act](https://digital-strategy.ec.europa.eu/en/policies/cyber-resilience-act).
3636

37-
This helps you evaluate how secure a repository is and how attentive maintainers are to compliance issues. It's also a good metric to evaluate whether or not a repo is secure. Users can see the security scores of all their dependencies.
37+
This helps users understand and evaluate how secure a repository is and how attentive maintainers are to compliance issues. It is a good metric to consider when contributing to a repository.
3838

39-
Additionally, you can create [SBOMs (Software Bill of Materials)](../../../features/repo-pages/#create-a-workspace-from-sbom) for projects you use or want to contribute to. This contains a list of all the parts used to build a software including dependencies and libraries. You can read more about [SBOM here](https://opensauced.pizza/blog/security-and-SBOMs).
39+
Additionally, [SBOMs (Software Bill of Materials)](../../../features/repo-pages/#create-a-workspace-from-sbom) can be created for projects used. This contains a list of all the parts used to build software, including dependencies and libraries. Read more about [SBOM here](https://opensauced.pizza/blog/security-and-SBOMs).
4040

41-
You can read more about [what it is and why it is important](https://opensauced.pizza/blog/introducing-openssf-scorecard-for-opensauced).
41+
Read more about [what it is and why it is important](https://opensauced.pizza/blog/introducing-openssf-scorecard-for-opensauced).
4242

4343
## Lottery Factor
4444

4545
[Lottery Factor](../glossary/#lottery-factor) is a metric that measures the risk that comes with a project’s dependence on one or a few key contributors. It measures how many pull requests are made by the most active contributors as a percentage.
4646

47-
This helps you understand whether or not a repository is at risk of abandonment should a key contributor become unavailable. This information is particularly important if you plan on being a long-term contributor or if your project relies on an open-source project for the long term.
47+
This helps users understand whether a repository is at risk of abandonment should a key contributor become unavailable. This information is particularly important if a contributor plans to remain a long-term contributor or if a project relies on an open-source project for the long term.
4848

49-
You can read more about [what it is and how it can be interpreted](https://opensauced.pizza/blog/Understanding-the-Lottery-Factor).
49+
Read more about [what it is and how it can be interpreted](https://opensauced.pizza/blog/Understanding-the-Lottery-Factor).
5050

5151
## Repositories as a Dataset
5252

5353
[Repositories as a Dataset](../glossary/#repository-insights) refers to viewing repositories as complete and in-depth information sources. It suggests holistically treating repositories by considering GitHub discussions, issues, and general activity and considering the history of entire repositories.
5454

5555
In the context of AI and its role in aiding developers, treating Repositories as a dataset helps train more context-aware AI models and makes this information more accessible.
5656

57-
This is helpful, as having more context around a repository you want to contribute to can make the process of contributing and onboarding much smoother.
57+
This is helpful, as having more context around a repository can make contributing and onboarding much smoother.
5858

59-
You can read more about [the case for treating repositories as datasets and why that is important](https://opensauced.pizza/blog/github-repos-as-datasets).
59+
Read more about [the case for treating repositories as datasets and why that is important](https://opensauced.pizza/blog/github-repos-as-datasets).
6060

6161
## YOLO Coders
6262

@@ -66,4 +66,4 @@ Proposing changes through PRs helps increase visibility and offers an opportunit
6666

6767
Using PRs and established means of making code changes reduces the chances of project bugs and preserves project history.
6868

69-
You can read more about [what it is and why it is not the best practice](https://opensauced.pizza/blog/yolo-coder).
69+
Read more about [what it is and why it is not the best practice](https://opensauced.pizza/blog/yolo-coder).

0 commit comments

Comments
 (0)