refactor: setup a docs directory for different readme's

This commit is contained in:
MiscFrizzy 2025-05-22 14:06:01 -04:00
parent 032a0f17f6
commit 6da03c2920
2 changed files with 0 additions and 0 deletions

45
docs/BADGE_SETUP.md Normal file
View file

@ -0,0 +1,45 @@
# Setting Up GitHub Badges
This document explains how to set up the GitHub Secrets required for the test status badge functionality.
## Steps to Create a GitHub Gist for Badge Storage
1. Create a new public GitHub Gist at https://gist.github.com/
- Add a file named `vrcauthproxy-tests.json` with the following content:
```json
{
"schemaVersion": 1,
"label": "tests",
"message": "unknown",
"color": "lightgrey"
}
```
- Save the Gist
2. Note the Gist ID from the URL
- The URL will look like: `https://gist.github.com/YOUR_USERNAME/GIST_ID`
- Copy the `GIST_ID` part
## Creating GitHub Secrets
1. In your VRCAuthProxy repository, go to **Settings** > **Secrets and variables** > **Actions**
2. Create the following secrets:
- **GIST_ID**
- Value: The Gist ID you copied in step 2 above
- **GIST_SECRET**
- Value: A GitHub Personal Access Token (PAT) with `gist` scope
- To create a PAT, go to your GitHub account **Settings** > **Developer settings** > **Personal access tokens** > **Tokens (classic)**
- Generate a new token with at least the `gist` scope
- Copy the token value (you won't be able to see it again after leaving the page)
3. Update the README.md badge URL
- Replace `USER_PLACEHOLDER` with your GitHub username
- Replace `GIST_ID_PLACEHOLDER` with your Gist ID
## Testing the Setup
After setting up the secrets and updating the README.md, push a commit to the main branch to trigger the workflow that will update the badge status.
If everything is set up correctly, the badge in the README should display the current test status (passing or failing).