From 8d3ecacb518d9bd461ece8eae72bf0135d4621af Mon Sep 17 00:00:00 2001 From: Ruaridh <86845749+RooRay@users.noreply.github.com> Date: Wed, 5 Mar 2025 19:49:55 +0000 Subject: [PATCH 1/3] Update README.md --- README.md | 12 +----------- 1 file changed, 1 insertion(+), 11 deletions(-) diff --git a/README.md b/README.md index b4d131f..251d213 100644 --- a/README.md +++ b/README.md @@ -10,17 +10,7 @@ You can view the latest build of the site [here](https://discordtickets.app/). ## Contributing -For simple changes, you can easily create a fork, edit the files you want to change, open a PR, and see the result with the PR deploy preview from the Netlify bot. - -**If you are editing tables**, please clone the repository locally, edit with an appropriate IDE (such as VS Code) and use a markdown formatting extension. - -### Local preview - -If you want to preview locally, clone the repo and then run `pip install -r requirements.txt` and `mkdocs serve`. - -If you choose to run a local preview, the site will not look the same as the production version, -because it is built with a specific version of the Insiders edition of the theme, which has additional features and a different config. -This is normal as the v4 documentation uses a newer version of MkDocs that is configured differently. +See [CONTRIBUTING.md](./CONTRIBUTING.md) ## Spontaneous Puffin Image From 3e9a70ef682a9808da84dc25d841a215a41bf247 Mon Sep 17 00:00:00 2001 From: Ruaridh <86845749+RooRay@users.noreply.github.com> Date: Wed, 5 Mar 2025 20:26:03 +0000 Subject: [PATCH 2/3] feat: Add CONTRIBUTING.md and improve the guidance --- CONTRIBUTING.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..01aa01c --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,17 @@ +## Contributing Guide + +For simple changes, you can easily create a fork, edit the files you want to change, open a PR, and see the result with the PR deploy preview from the Netlify bot. + +> [!CAUTION] +> The documentation only supports *British* English for written language. [Spell checks](https://github.com/discord-tickets/docs/actions/workflows/spelling-check.yml) will fail if you use other languages or other forms of English. Code, code snippets, config files, etc can be in American English. + +> [!TIP] +> If you are editing tables, please clone the repository locally and edit it with an appropriate IDE (like VS Code) using a markdown formatting extension. + +### Local preview + +If you want to preview locally, clone the repo and then run `pip install -r requirements.txt` and `mkdocs serve`. + +If you choose to run a local preview, the site will not look the same as the production version, this is because it is built with a specific version of the Insiders edition of the theme, which has additional features and a different config. + +This is normal as the v4 documentation uses a newer version of MkDocs that is configured differently. From ed5b49e50e4801f248b24ec6d6f8f697fa4665e9 Mon Sep 17 00:00:00 2001 From: Ruaridh <86845749+RooRay@users.noreply.github.com> Date: Wed, 5 Mar 2025 20:26:29 +0000 Subject: [PATCH 3/3] chore: remove dead link to v3 docs --- README.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/README.md b/README.md index 251d213..061590c 100644 --- a/README.md +++ b/README.md @@ -5,9 +5,6 @@ This is the source for the Discord Tickets v4 documentation (and marketing) website. You can view the latest build of the site [here](https://discordtickets.app/). -> **Note** -> For the v3 documentation, visit [v3.discordtickets.app](https://v3.discordtickets.app) or look at the `v3.1` branch. - ## Contributing See [CONTRIBUTING.md](./CONTRIBUTING.md)