From 846efba9fe0a6780aca0e6b52c9fd7dbb89af49f Mon Sep 17 00:00:00 2001
From: Samq64 <81489795+Samq64@users.noreply.github.com>
Date: Mon, 18 Aug 2025 11:28:18 -0400
Subject: [PATCH 1/4] Docs: Clarify installation and addons.json position
---
content/docs/develop/getting-started/creating-an-addon.md | 4 ++--
content/docs/getting-started/installing.md | 7 ++++---
2 files changed, 6 insertions(+), 5 deletions(-)
diff --git a/content/docs/develop/getting-started/creating-an-addon.md b/content/docs/develop/getting-started/creating-an-addon.md
index 1d7e668c5..18cfec30c 100644
--- a/content/docs/develop/getting-started/creating-an-addon.md
+++ b/content/docs/develop/getting-started/creating-an-addon.md
@@ -12,7 +12,7 @@ If you plan to submit the addon you are developing as a pull request to our GitH
{{< /admonition >}}
## Requirements
-Scratch Addons does not require any software for development except a text editor and a Chromium-based browser (121+), but we also recommend having Git, Firefox (121+) and Visual Studio Code installed.
+Scratch Addons does not require any software for development except a text editor and a Chromium-based browser (121+), but we also recommend having [Git](https://git-scm.com/), [Firefox](https://www.firefox.com/) (121+) and [Visual Studio Code](https://code.visualstudio.com/) installed.
## Installation
To install the extension for development, see [Installing from source](/docs/getting-started/installing/#from-source).
@@ -32,7 +32,7 @@ New addons should not use an ID that was included in a stable version of the ext
- `scratchstats`
- `tutorials-button`
-Open the `addons.json` file in the `addons` folder, insert a new addon ID near the bottom of the file, then create a sub-folder with the same name.
+Open the `addons.json` file in the `addons` folder, insert a new addon ID near the bottom of the file but above the `// NEW ADDONS ABOVE THIS ↑↑` line, then create a sub-folder with the same name.
## The addon manifest
Each addon has it's own [manifest](/docs/reference/addon-manifest/) that handles how it is displayed on the settings page, any settings the addon may have, which userscripts or userstyles to run and where to run them.
diff --git a/content/docs/getting-started/installing.md b/content/docs/getting-started/installing.md
index 3a36c5521..87065269e 100644
--- a/content/docs/getting-started/installing.md
+++ b/content/docs/getting-started/installing.md
@@ -16,15 +16,16 @@ Scratch Addons is available in these stores.
| Add-ons for Firefox | [](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) | Mozilla Firefox 109+ | Windows 7+
OS X / MacOS 10.12+
| Microsoft Edge Add-ons | [](https://microsoftedge.microsoft.com/addons/detail/iliepgjnemckemgnledoipfiilhajdjj) | Microsoft Edge 96+ | Windows 7+
OS X / MacOS 10.11+
+## About GitHub releases
+
+[The releases page](https://github.com/ScratchAddons/ScratchAddons/releases) contains the code and installation files for all released versions of Scratch Addons, as well as a mirror of the store builds.
+
## From source
{{< admonition info >}}
Unlike the store releases, installing from source requires a browser based on Chromium 121+ or Firefox 121+.
{{< /admonition >}}
-### About GitHub releases
-
-[The releases page](https://github.com/ScratchAddons/ScratchAddons/releases) contains the code and installation files for all development builds of Scratch Addons, as well as the mirror of the store builds.
### Cloning the repository
From 781c83ff24bc9cb162dcf26004bc63dce922e58a Mon Sep 17 00:00:00 2001
From: Samq64 <81489795+Samq64@users.noreply.github.com>
Date: Mon, 18 Aug 2025 11:42:02 -0400
Subject: [PATCH 2/4] Remove mention of installation files
---
content/docs/getting-started/installing.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/content/docs/getting-started/installing.md b/content/docs/getting-started/installing.md
index 87065269e..89fb17202 100644
--- a/content/docs/getting-started/installing.md
+++ b/content/docs/getting-started/installing.md
@@ -18,7 +18,7 @@ Scratch Addons is available in these stores.
## About GitHub releases
-[The releases page](https://github.com/ScratchAddons/ScratchAddons/releases) contains the code and installation files for all released versions of Scratch Addons, as well as a mirror of the store builds.
+[The releases page](https://github.com/ScratchAddons/ScratchAddons/releases) contains the code for all released versions of Scratch Addons, as well as a mirror of the store builds.
## From source
From b5274c8d15914da400a904602ba91142c6c9921b Mon Sep 17 00:00:00 2001
From: Samq64 <81489795+Samq64@users.noreply.github.com>
Date: Mon, 18 Aug 2025 14:42:49 -0400
Subject: [PATCH 3/4] Move GitHub releases below cloning
---
content/docs/getting-started/installing.md | 8 +++-----
1 file changed, 3 insertions(+), 5 deletions(-)
diff --git a/content/docs/getting-started/installing.md b/content/docs/getting-started/installing.md
index 89fb17202..07f14d1ad 100644
--- a/content/docs/getting-started/installing.md
+++ b/content/docs/getting-started/installing.md
@@ -16,17 +16,12 @@ Scratch Addons is available in these stores.
| Add-ons for Firefox | [](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) | Mozilla Firefox 109+ | Windows 7+
OS X / MacOS 10.12+
| Microsoft Edge Add-ons | [](https://microsoftedge.microsoft.com/addons/detail/iliepgjnemckemgnledoipfiilhajdjj) | Microsoft Edge 96+ | Windows 7+
OS X / MacOS 10.11+
-## About GitHub releases
-
-[The releases page](https://github.com/ScratchAddons/ScratchAddons/releases) contains the code for all released versions of Scratch Addons, as well as a mirror of the store builds.
-
## From source
{{< admonition info >}}
Unlike the store releases, installing from source requires a browser based on Chromium 121+ or Firefox 121+.
{{< /admonition >}}
-
### Cloning the repository
This is the recommended way to install Scratch Addons for development purposes, assuming you have Git installed.
@@ -45,6 +40,9 @@ $ git pull
Remember to also update Scratch Addons from the browser.
+### About GitHub releases
+
+[The releases page](https://github.com/ScratchAddons/ScratchAddons/releases) contains the code for all released versions of Scratch Addons, as well as a mirror of the store builds.
### Downloading the Zip
From 7a16157ff7619156ead33db191d6695460d1ea77 Mon Sep 17 00:00:00 2001
From: Samq64 <81489795+Samq64@users.noreply.github.com>
Date: Mon, 18 Aug 2025 14:43:21 -0400
Subject: [PATCH 4/4] Improve addons.json wording
Co-authored-by: Maximouse
---
content/docs/develop/getting-started/creating-an-addon.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/content/docs/develop/getting-started/creating-an-addon.md b/content/docs/develop/getting-started/creating-an-addon.md
index 18cfec30c..be95b981a 100644
--- a/content/docs/develop/getting-started/creating-an-addon.md
+++ b/content/docs/develop/getting-started/creating-an-addon.md
@@ -32,7 +32,7 @@ New addons should not use an ID that was included in a stable version of the ext
- `scratchstats`
- `tutorials-button`
-Open the `addons.json` file in the `addons` folder, insert a new addon ID near the bottom of the file but above the `// NEW ADDONS ABOVE THIS ↑↑` line, then create a sub-folder with the same name.
+Open the `addons.json` file in the `addons` folder, insert a new addon ID above the `// NEW ADDONS ABOVE THIS ↑↑` line near the bottom of the file, then create a sub-folder with the same name.
## The addon manifest
Each addon has it's own [manifest](/docs/reference/addon-manifest/) that handles how it is displayed on the settings page, any settings the addon may have, which userscripts or userstyles to run and where to run them.