feat: add section for key metrics guide (#412)

* chore: add key metrics guide entry to sidebar

* feat: add key metrics guide file and front matter

* docs: add OSCR section

* fix: update links to use relative paths

* docs: add contributor confidence section

* docs: add OSSF section

* docs: add lottery factor section

* docs: add repositories as a dataset section

* fix: flow check to tighten up the draft

* fix: grammar, word choice, sentence structure

* docs: add yolo coders section

* docs: tie SBOM to OSSF

* enhancement: use 3rd person

docs/welcome/key-metrics-guide.md

@@ -0,0 +1,69 @@
+---
+id: key-metrics-guide
+title: "Key Metrics Guide"
+sidebar_label: "Key Metrics Guide"
+keywords:
+  - "metrics"
+  - "openSauced"
+  - "OpenSauced metrics guide"
+  - "Key metrics guide"
+  - "Open Source metric guide"
+---
+
+Welcome to the Key Metrics Guide, where we define the main metrics used on our platform to help users better understand them.
+
+## OSCR
+
+[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.
+
+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.
+
+Read more about [what it is and how to improve it](../../opensauced-guides/oscr-score-guide/oscr-guide/).
+
+## Contributor Confidence
+
+[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.
+
+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.
+
+Read more about [what it is and how it can be interpreted](../../features/repo-pages/#insights-into-contributor-confidence).
+
+## OpenSSF Score
+
+[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.
+
+[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).
+
+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.
+
+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).
+
+Read more about [what it is and why it is important](https://opensauced.pizza/blog/introducing-openssf-scorecard-for-opensauced).
+
+## Lottery Factor
+
+[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.
+
+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.
+
+Read more about [what it is and how it can be interpreted](https://opensauced.pizza/blog/Understanding-the-Lottery-Factor).
+
+## Repositories as a Dataset
+
+[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.
+
+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.
+
+This is helpful, as having more context around a repository can make contributing and onboarding much smoother.
+
+Read more about [the case for treating repositories as datasets and why that is important](https://opensauced.pizza/blog/github-repos-as-datasets).
+
+## YOLO Coders
+
+[YOLO Coders](../glossary/#yolo-coders) refers to repository owners, contributors or maintainers who push code changes directly to a project's default branch without going through a pull request (PR).
+
+Proposing changes through PRs helps increase visibility and offers an opportunity for code reviews and discussions. This increases collaboration and makes potential contributors more likely to engage.
+
+Using PRs and established means of making code changes reduces the chances of project bugs and preserves project history.
+
+Read more about [what it is and why it is not the best practice](https://opensauced.pizza/blog/yolo-coder).

sidebars.js

@@ -16,7 +16,7 @@ module.exports = {
       type: "category",
       label: "Getting Started",
       collapsed: false,
-      items: ["welcome/opensauced-intro", "welcome/glossary", "welcome/faqs"],
+      items: ["welcome/opensauced-intro", "welcome/key-metrics-guide", "welcome/glossary", "welcome/faqs"],
     },
     {
       type: "category",