| description |
|---|
Tutorials are an awesome way to help out Audacity users. So if you know how to use Audacity, you might be just the right person to teach others! You can either write guides, or make videos. |
{% hint style="info" %}
- Go to audacityteam.org/gitbook-access to get editor access to this site
- Go to audacityteam.org/gitbook-plugins to get access to the Plugins site
- Or check out editing-through-github.md to edit with a local text editor or on Github.com {% endhint %}
Audacity welcomes contributions to both Audacity Support and Audacity Plugins, whether it's a small spelling correction or an entirely new guide. If you're not sure what to start with, check out some good first issues:
{% embed url="https://github.com/audacity/audacity-support/contribute" %}
Gitbook works a bit like a wiki in that you can edit all pages freely, but unlike a wiki, it uses git's "everyone has their own branch" principle. That is to say that the changes you make are independent of everyone else's changes, and won't show up on the main (live) website until the branches are merged.
To some degree, this means that you can do whatever you want in your branch. That said, there's some things which make things easier for everyone involved:
{% hint style="success" %} Best practice
-
Do one task per branch. Want to make a new guide on a new feature? Make a new branch. Want to remove all instances of the oxford comma? Make another branch. You can click the branch icon in the top bar to make new branches.
Doing so makes it easier to understand what your changes are exactly, and should one of your changes be rejected, most of your other work won't get blocked by it.
-
Only submit complete pages. Your progress is saved automatically, so if you want to call it for the day, simply close the page and continue the next day. If you accidentally hit "submit", simply start editing again to convert your branch to a draft branch again.
-
Be aware of the others, to avoid duplicate work. You may connect with other editors in our discord servers.
-
Follow the style-guide.md, to give this entire site a somewhat uniform style. {% endhint %}
When editing on Gitbook, you can edit existing pages, but you cannot create new ones. If you'd like to make a page about a new topic, write to LWinterberg in the discord server. You also can hand in Markdown files or Word documents to him directly to add. This restriction does not apply when editing-through-github.md, however, there are other technical oddities when editing through GitHub.
Video tutorials are highly appreciated as part of a guide. You can upload them to YouTube (or Vimeo/Dailymotion/...) and embed them in your guides, or in other people's guides, like this:
{% embed url="https://youtu.be/DTRnDNR9LR8" %}
We have some requirements for which video tutorials are accepted into Audacity Support pages (see the Style Guide #video-tutorials for more info)