Editing through GitHub
A link for GitHub is shown either on the right-hand side or in an overflow menu of any page:
Once you are on GitHub, you will see a pencil in the top right of the file.
On a technical level, this will create a "fork" of the page, found on your Github profile, with a new branch called "patch-#" in which you are editing. As long as you are within this branch, you can do whatever you want with out stepping on anyone's toes.
You now can make your changes to the page.
Once you are done, press Propose Changes
On a technical level, this creates a commit in your "patch-#" branch. A branch can hold as many commits as you like, so if you want to do multiple changes, you can exit the flow after clicking "propose changes" and edit another file instead.
This brings you to a page where you can review your changes. If you are satisfied, click Create Pull Request.
Clicking this button creates a form...
... in which you can give an overview of your changes to the team.
You can edit Markdown in any text editor. More advanced editors like VSCode may show useful shortcuts and visualizations for easier and faster editing, but in principle, even the simplest text editors like Windows Notepad can be used to create them.
Once it's cloned, you'll find the files of support.audacityteam.org in the
mainbranch, and the files of plugins.audacityteam.org in the
pluginsbranch. Any additional branches have been split off from the main branch to preserve documentation for previous versions of Audacity.
Example of switching branches in the GitHub Desktop client
Example of switching branches in VSCode
- The sidebar menu is handled through SUMMARY.md, not the file structure itself. If you want the page you created to show up in the sidebar, you will need to update this file accordingly. That said: Try to match the structure of SUMMARY.md with the folder structure.
- While you technically can work directly in your fork's main/plugins branch, it is highly recommended to make a new branch based on
upstream/pluginsinstead for your changes. This way, you can always fast-forward merge the latest changes into your fork.
- When updating your fork's side-branches to the latest state of main, rebase it if possible.