GitBook: [#127] removing todo-mentions in-text + image names

README.md

@@ -7,7 +7,7 @@ description: How-Tos and Tutorials for Audacity
 {% hint style="warning" %}
 Audacity Support still is in a very early stage and under heavy development. 
 
-Do check out [tutorials](contributing/tutorials/ "mention") if you want to contribute.
+Do check out [tutorials](community/contributing/tutorials/ "mention") if you want to contribute.
 {% endhint %}
 
 Quick links to get started: 

SUMMARY.md

@@ -1,26 +1,6 @@
 # Table of contents
 
 * [Audacity Support](README.md)
-* [Contributing](contributing/README.md)
-  * [Making Tutorials and User Guides](contributing/tutorials/README.md)
-    * [Style Guide](contributing/tutorials/style-guide.md)
-    * [Editing through GitHub](contributing/tutorials/editing-through-github.md)
-    * [TODO](contributing/tutorials/todo/README.md)
-      * [Adding realtime effects](contributing/tutorials/todo/adding-realtime-effects.md)
-      * [ASIO in Audacity](contributing/tutorials/todo/asio-in-audacity.md)
-      * [Synchronizing Tracks](contributing/tutorials/todo/synchronizing-tracks/README.md)
-        * [Keeping Tracks Synchronized](contributing/tutorials/todo/synchronizing-tracks/keeping-tracks-synchronized.md)
-      * [Using Macros to Automate Frequent Tasks](contributing/tutorials/todo/using-macros-to-automate-frequent-tasks.md)
-      * [Using looping Playback](contributing/tutorials/todo/using-looping-playback.md)
-      * [Mastering for Audio Books](contributing/tutorials/todo/mastering-for-audio-books.md)
-      * [How to use Audacity](contributing/tutorials/todo/how-to-use-audacity.md)
-      * [Working with Tracks](contributing/tutorials/todo/untitled.md)
-  * [Answering user questions](contributing/answering.md)
-  * [Translating Audacity](contributing/translating.md)
-  * [Developing Audacity](contributing/developing.md)
-  * [Testing the latest features](contributing/testing.md)
-  * [Plugins](contributing/plugins.md)
-  * [Credits & License](contributing/credits-and-license.md)
 
 ## Audacity Basics <a href="#basics" id="basics"></a>
 
@@ -65,6 +45,26 @@
 
 ## Community
 
+* [Contributing to Audacity](community/contributing/README.md)
+  * [Making Tutorials and User Guides](community/contributing/tutorials/README.md)
+    * [Style Guide](community/contributing/tutorials/style-guide.md)
+    * [Editing through GitHub](community/contributing/tutorials/editing-through-github.md)
+    * [TODO](community/contributing/tutorials/todo/README.md)
+      * [Adding realtime effects](community/contributing/tutorials/todo/adding-realtime-effects.md)
+      * [ASIO in Audacity](community/contributing/tutorials/todo/asio-in-audacity.md)
+      * [Synchronizing Tracks](community/contributing/tutorials/todo/synchronizing-tracks/README.md)
+        * [Keeping Tracks Synchronized](community/contributing/tutorials/todo/synchronizing-tracks/keeping-tracks-synchronized.md)
+      * [Using Macros to Automate Frequent Tasks](community/contributing/tutorials/todo/using-macros-to-automate-frequent-tasks.md)
+      * [Using looping Playback](community/contributing/tutorials/todo/using-looping-playback.md)
+      * [Mastering for Audio Books](community/contributing/tutorials/todo/mastering-for-audio-books.md)
+      * [How to use Audacity](community/contributing/tutorials/todo/how-to-use-audacity.md)
+      * [Working with Tracks](community/contributing/tutorials/todo/untitled.md)
+  * [Answering user questions](community/contributing/answering.md)
+  * [Translating Audacity](community/contributing/translating.md)
+  * [Developing Audacity](community/contributing/developing.md)
+  * [Testing the latest features](community/contributing/testing.md)
+  * [Plugins](community/contributing/plugins.md)
+  * [Credits & License](community/contributing/credits-and-license.md)
 * [💬 Discord](https://discord.gg/audacity)
 * [💬 Forum](https://forum.audacityteam.org/)
 * [Info for Visually Impaired Users](https://vip.chowo.co.uk/wp-content/uploads/jaws/Audacity-3.1.0-Guide.html)

audio-analysis/untitled.md

@@ -4,19 +4,19 @@ description: >-
   track, Plot Spectrum, as well as support for Plugins.
 ---
 
-# Spectral Analysis
+# Spectral analysis
 
 ## Spectrogram View
 
 Each track in Audacity can be viewed in a Spectrogram view:
 
-![Spectrogram view of a track](<../.gitbook/assets/image (24).png>)
+![Spectrogram view of a track](../.gitbook/assets/spectrogram.png)
 
 To access it, click on the **track menu dropdown** and select **Spectrogram.**
 
 The track menu also features Spectrogram settings, where you can tweak the scale, the colors, the used algorithms and the window size.
 
-![The Track Menu dropdown](<../.gitbook/assets/image (8).png>)
+![The Track Menu dropdown](<../.gitbook/assets/track menu spectrogram.png>)
 
 {% hint style="info" %}
 **Tip:** To view the waveform and the spectrogram at the same time, choose **Multi-view** instead.
@@ -52,7 +52,7 @@ To use Plot Spectrum,&#x20;
 1. **select** the audio you're interested in analyzing
 2. go to **Analyze -> Plot Spectrum**.
 
-![The Plot Spectrum Window](<../.gitbook/assets/image (17).png>)
+![The Plot Spectrum Window](<../.gitbook/assets/plot spectrum.png>)
 
 ### Options
 

audio-editing/making-audio-loops.md

@@ -4,7 +4,7 @@ description: >-
   a pre-existing audio file.
 ---
 
-# Making Audio Loops
+# Making audio loops
 
 Audio loops are a type of music that plays a few bars on repeat over and over. They can be created by taking a sample out of pre-existing content and looping it seamlessly. 
 
@@ -32,12 +32,12 @@ When making a loop out of music, you often will be able to see repetitions in th
 
 ### Fine-tuning the loop and removing clicks
 
-To make the loop seamless, you may need to zoom in some more, using `Ctrl+Scroll` (`Cmd+Scroll`) or the ![](<../.gitbook/assets/image (14).png>) magnifying glass.&#x20;
+To make the loop seamless, you may need to zoom in some more, using `Ctrl+Scroll` (`Cmd+Scroll`) or the ![](../.gitbook/assets/ZoomIn.png) magnifying glass.&#x20;
 
 {% hint style="success" %}
 Best practice: Set your looping points at a zero crossing, where the waveform (blue line) crosses 0 (black line):&#x20;
 
-![](<../.gitbook/assets/image (3).png>)
+![](<../.gitbook/assets/zero crossing.png>)
 {% endhint %}
 
 ## 3. Turn your loop into a clip

audio-editing/making-crossfades.md

@@ -4,7 +4,7 @@ description: >-
   are several methods to achieve this in Audacity
 ---
 
-# Making Crossfades
+# Making crossfades
 
 ## Crossfading Clips
 
@@ -13,7 +13,7 @@ If you have two clips in one track you'd like to crossfade, you can use **Crossf
 1. Have two clips in one track.
 2.  Select the region you'd like to apply the crossfade to. Try to select roughly the same amount of time in both clips.
 
-    ![](<../.gitbook/assets/image (23).png>)\
+    ![](../.gitbook/assets/waveforms.png)\
     **Note:** Any empty space between the clips will be automatically removed and ignored in the crossfade.&#x20;
 3. Use **Effects > Crossfade Clips** to crossfade the clips.&#x20;
 
@@ -23,6 +23,6 @@ To crossfade between tracks, use the following steps:&#x20;
 
 1.  Position the clips on the tracks so that they overlap in the range you want to crossfade:
 
-    ![](<../.gitbook/assets/image (6) (1) (1).png>)
+    ![](<../.gitbook/assets/track overlap.png>)
 2. Select the audio in the first clip in the overlapping region and choose **Effects > Fade Out**
 3. Select the audio in the second clip in the overlapping region and choose **Effects > Fade In**

audio-editing/speeding-up-and-slowing-down-audio.md

@@ -2,7 +2,7 @@
 description: Audacity has several methods available to change speed and tempo of audio.
 ---
 
-# Speeding up and Slowing down Audio
+# Speeding up and slowing down audio
 
 ## Changing the speed while preserving pitch
 
@@ -12,13 +12,13 @@ description: Audacity has several methods available to change speed and tempo of
 
 To change the speed while preserving the pitch, select the audio you want to apply the effect on and go to **Effect > Change Tempo**
 
-![The "Change Tempo" Effect dialog](<../.gitbook/assets/image (9).png>)
+![The "Change Tempo" Effect dialog](<../.gitbook/assets/change tempo.png>)
 
 Drag the slider or enter some numbers to change how much you want to speed up or slow down your audio. The controls are linked, so you just need to change the value you care about, the rest will update accordingly.&#x20;
 
 For extreme slowdowns (10x slower to thousands of times slower), you may want to use **Effect > Paulstretch** instead.&#x20;
 
-![The "Paulstretch" Effect dialog](<../.gitbook/assets/image (16).png>)
+![The "Paulstretch" Effect dialog](../.gitbook/assets/paulstretch.png)
 
 {% hint style="info" %}
 **Note:** Paulstretch is only capable of slowing down, so the stretch factor relates to how many times you want to slow down your audio.&#x20;
@@ -30,7 +30,7 @@ The time resolution decides on whether the algorithm will focus on frequencies a
 
 To change speed and pitch at the same time, use **Effect > Change Speed**.
 
-![The "Change speed" effect dialog](<../.gitbook/assets/image (10).png>)
+![The "Change speed" effect dialog](<../.gitbook/assets/change speed.png>)
 
 Unlike [Change Tempo](speeding-up-and-slowing-down-audio.md#changing-the-speed-while-preserving-pitch), the Change Speed effect keeps the waveform mostly intact, so you can use this method repeatedly without any major loss in quality.&#x20;
 

audio-editing/splitting-a-recording-into-separate-tracks/README.md

@@ -5,7 +5,7 @@ description: >-
   export each song into a separate file.
 ---
 
-# Splitting a Recording into Separate Tracks
+# Splitting a recording into separate tracks
 
 ### Remove unwanted audio from the recording
 
@@ -29,7 +29,7 @@ Later in this tutorial we mention that you can use the **Analyze > Label Sounds.
 
 **Mark the start of the first song**
 
-1. Click the **Skip to Start** button ![](<../../.gitbook/assets/image (6) (1).png>)
+1. Click the **Skip to Start** button ![](../../.gitbook/assets/Rewind.png)
 2.  Click on **Edit > Labels >** [**Add Label at Selection**](https://manual.audacityteam.org/man/edit\_menu\_labels.html#addlabelatselection), or use shortcut **Ctrl + B**.
 
     A new label is created in a new [label track](https://manual.audacityteam.org/man/label\_tracks.html) underneath the audio track. The contents of the label are selected and ready for editing. If you need to play the track to decide where to place the split points, you can use **Add Label at Playback Position** instead (directly underneath [Add Label at Selection](https://manual.audacityteam.org/man/edit\_menu\_labels.html#addlabelatselection), or use shortcut **Ctrl + M** _(on Mac it is **⌘ + .**)_.
@@ -45,7 +45,7 @@ Later in this tutorial we mention that you can use the **Analyze > Label Sounds.
 6. Repeatedly click the **Zoom Out** button ![The Zoom Out tool](https://manual.audacityteam.org/m/images/d/d3/tool\_edit\_zoomout.png) until you can see the start of the third song
 7. Continue in this manner adding a label to mark the start of each song
 
-![Label at the start of the second song in the audio track](<../../.gitbook/assets/image (7) (1).png>)
+![Label at the start of the second song in the audio track](<../../.gitbook/assets/song2 label.png>)
 
 {% hint style="info" %}
 You can save time by using **Analyze >** [**Label Sounds...**](https://manual.audacityteam.org/man/label\_sounds.html) to automatically label the regions to be exported for the songs. This method thus lets you exclude some or all of the areas between songs.

audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md

@@ -9,7 +9,7 @@ description: >-
 
 Any [built-in](https://manual.audacityteam.org/man/effect\_menu.html#built-in), [LADSPA](https://manual.audacityteam.org/man/effect\_menu\_ladspa.html), [LV2](https://manual.audacityteam.org/man/effect\_menu\_lv2.html), [Nyquist](https://manual.audacityteam.org/man/effect\_menu\_nyquist.html), [VST](https://manual.audacityteam.org/man/effect\_menu\_vst.html) or [Audio Unit](https://manual.audacityteam.org/man/effect\_menu\_audiounit.html) (Mac) effect shown in the [Effect Menu](https://manual.audacityteam.org/man/effect\_menu.html) can be added to a Macro. You can also add plug-ins in any format that are shown in the [Generate](https://manual.audacityteam.org/man/generate\_menu.html) or [Analyze](https://manual.audacityteam.org/man/analyze\_menu.html) Menus (including [Vamp](https://manual.audacityteam.org/man/analyze\_menu.html#vamp) analysis effects), the built-in [Find Clipping](https://manual.audacityteam.org/man/find\_clipping.html) analyzer and a number of export commands.
 
-Macros may be applied to either the entirety of the current project or to a selection of files using the Tools > [Macros...](../../contributing/tutorials/todo/using-macros-to-automate-frequent-tasks.md) command.
+Macros may be applied to either the entirety of the current project or to a selection of files using the Tools > [Macros...](../../community/contributing/tutorials/todo/using-macros-to-automate-frequent-tasks.md) command.
 
 It is possible to use [Noise Reduction](https://manual.audacityteam.org/man/noise\_reduction.html) in Macros but see [Noise Reduction Tips](https://manual.audacityteam.org/man/noise\_reduction.html#macros) for how the Noise Profile is captured.
 

basics/audacity-editing.md

@@ -4,7 +4,7 @@ description: >-
   import files, making cuts, rearranging clips, and applying effects!
 ---
 
-# Editing Audio
+# Editing audio
 
 ## Importing a file
 
@@ -27,7 +27,7 @@ To remove a section of an audio file, first select the section by **clicking and
 ![A selected waveform](../.gitbook/assets/create\_selection.png)
 
 {% hint style="info" %}
-**Hint**: You can zoom in using the ![](<../.gitbook/assets/image (14).png>)Zoom+ icon, or by `Ctrl+Scroll` (`Cmd+Scroll`) to precisely adjust the beginning and end of the selection.
+**Hint**: You can zoom in using the ![](../.gitbook/assets/ZoomIn.png)Zoom+ icon, or by `Ctrl+Scroll` (`Cmd+Scroll`) to precisely adjust the beginning and end of the selection.
 {% endhint %}
 
 Once you have a selection, press `Delete` or `Backspace` to delete it.&#x20;

basics/downloading-and-installing-audacity/installing-ffmpeg.md

@@ -25,17 +25,17 @@ If you have installed FFMPEG from a different source, or installed it in a diffe
 1. Go to **Edit > Preferences > Libraries**
 2.  Click on the **Locate...** button. 
 
-    ![](<../../.gitbook/assets/image (4).png>)
+    ![](<../../.gitbook/assets/ffmpeg prefs.png>)
 3.  **If the following message appears**, Audacity has automatically identified FFMPEG:
 
-    ![](<../../.gitbook/assets/image (19).png>)
+    ![](<../../.gitbook/assets/ffmpeg success.png>)
 
     You can click **No** as Audacity already knows where to find FFMPEG.&#x20;
 
     If this message **does not appear**, proceed with the next steps.
 4.  In this dialog window, click **Browse...** to locate the avformat-\*.dll from the FFMPEG folder you downloaded/installed elsewhere&#x20;
 
-    ![](<../../.gitbook/assets/image (11) (1).png>)
+    ![](<../../.gitbook/assets/ffmpeg locate.png>)
 5. Once you've found it, click **Open**, then **OK**, then **OK** again to close the preferences.&#x20;
 
 {% hint style="info" %}

basics/installing-plugins.md

@@ -1,8 +1,6 @@
 # Installing plugins
 
-* [ ] Update Nyquist instructions to 3.2
-
-You can download various plugins listed on the Audacity Plugins site:
+You can download various plugins here:
 
 {% content-ref url="https://app.gitbook.com/o/-MhmG2mhIIHTtQPuHV_k/s/klCVENFte0GRy5IqVz0W/" %}
 [Audacity Plugins](https://app.gitbook.com/o/-MhmG2mhIIHTtQPuHV\_k/s/klCVENFte0GRy5IqVz0W/)
@@ -59,7 +57,7 @@ Watch a step-by-step tutorial of this guide
 
 To install a Nyquist Plugin, follow these steps: 
 
-1. Download the plugin in question. You can find many on the wiki: [https://wiki.audacityteam.org/wiki/Download\_Nyquist\_Plug-ins](https://wiki.audacityteam.org/wiki/Download\_Nyquist\_Plug-ins) 
+1. Download the plugin in question. 
 2. Open Audacity, and go to **Tools > Nyquist Plugin Installer**
 3. Click **Browse** and locate your downloaded plugin
 4. Click **Open** and then **OK** and **OK** again. 

basics/recording-your-voice-and-microphone/README.md

@@ -1,6 +1,8 @@
-# Recording your voice & microphone
+---
+description: Audacity can record various types of microphones and other audio devices.
+---
 
-Audacity can record various types of microphones, 
+# Recording your voice & microphone
 
 ## 1. Connect your Microphone
 
@@ -44,7 +46,7 @@ Then try to speak in a normal volume. In general, the volume should remain in th
 
 Next, make a test recording. To start recording your voice in Audacity, simply press the red record button. 
 
-![Transport toolbar: the record button is the second from the right](../../.gitbook/assets/transport\_toolbar.png)
+![Transport toolbar: the record button is the second from the right](<../../.gitbook/assets/transport toolbar.png>)
 
 When you have made the recording, listen back to it. If everything went well, you should now hear your voice clearly and you should now be able to continue with the next steps.
 

community/contributing/plugins.md

@@ -35,7 +35,7 @@ _Download page_
 
 _Additional info, such as developer name, license and copyright info, a short "how to use" section or link to the documentation page, or a screenshot of the plugin - preferably of it working withing Audacity._
 
-<img src="../.gitbook/assets/image (17).png" alt="" data-size="original">
+<img src="../../.gitbook/assets/plot spectrum.png" alt="" data-size="original">
 
 
 

community/contributing/tutorials/README.md

@@ -22,7 +22,7 @@ To some degree, this means that you can do whatever you want in your branch. Tha
 {% hint style="success" %}
 **Best practice**
 
-1.  **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. ![](../../.gitbook/assets/gitbook-menu.png)
+1.  **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. ![](../../../.gitbook/assets/gitbook-menu.png)
 
     Doing so makes it easier to understand what your changes are exactly, and should one of your changes be rejected (we like the oxford comma!), most of your other work won't get blocked by it. 
 2. **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.

community/contributing/tutorials/editing-through-github.md

@@ -10,23 +10,23 @@ Any page of both support.audacityteam.org and plugins.audacityteam.org can be ed
 
 A link for GitHub is shown either on the right-hand side or in an overflow menu of any page:
 
-![](<../../.gitbook/assets/image (22).png>)
+![](<../../../.gitbook/assets/github edit wide.png>)
 
-![](<../../.gitbook/assets/image (7).png>)
+![](<../../../.gitbook/assets/github edit narrow.png>)
 
 Once you are on GitHub, you will see a pencil in the top right of the file.&#x20;
 
-![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. ](<../../.gitbook/assets/image (11).png>)
+![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. ](<../../../.gitbook/assets/github fork pencil.png>)
 
 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.](<../../.gitbook/assets/image (20).png>)
+![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.](<../../../.gitbook/assets/github propose changes.png>)
 
 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...](<../../.gitbook/assets/image (6).png>)
+![Clicking this button creates a form...](<../../../.gitbook/assets/github pr 1.png>)
 
-![... in which you can give an overview of your changes to the team.](<../../.gitbook/assets/image (21).png>)
+![... in which you can give an overview of your changes to the team.](<../../../.gitbook/assets/github pr 2.png>)
 
 After you click "create pull request", it will show up on [https://github.com/audacity/audacity-support/pulls](https://github.com/audacity/audacity-support/pulls) and await review by an Audacity team member.&#x20;
 
@@ -40,7 +40,7 @@ Caution: Avoid using office suites like Microsoft Word, LibreOffice or Google Do
 
 To get started, first clone the repository, either using `git clone` [`https://github.com/audacity/audacity-support.git`](https://github.com/audacity/audacity-support.git) by clicking the code button on [https://github.com/audacity/audacity-support](https://github.com/audacity/audacity-support) and opening it in GitHub Desktop
 
-![](<../../.gitbook/assets/image (5).png>)
+![](<../../../.gitbook/assets/github clone.png>)
 
 {% hint style="info" %}
 **Note:** You will need to use some form of Git to make a pull request, so just downloading the ZIP will not work.&#x20;
@@ -48,5 +48,5 @@ To get started, first clone the repository, either using `git clone` [`https://g
 
 Once it's cloned, you'll find the files of support.audacityteam.org in the `main` branch, and the files of plugins.audacityteam.org in the `plugins` branch. 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](<../../.gitbook/assets/image (13).png>)
+![Example of switching branches in the GitHub Desktop client](<../../../.gitbook/assets/github branch switch.png>)
 

community/contributing/tutorials/style-guide.md

@@ -14,9 +14,9 @@ The goal of the user guide is to provide explanations on how to perform various
 
 Documenting features seems like the obvious thing to do: Audacity has various menus, so better have a list of what every option in that menu does. However, this leads to the situation where some pages are completely unfindable as a reader already needs to know where certain options are in the menu in order to find out what the page would be called. For example, the feature containing the slider for the recording and playback volumes is called _Mixer Toolbar_. But nobody except the people most intimately familiar with Audacity know it's called that!
 
-To combat this, try to write your guides as a way towards a goal, or a **task**. The above example, instead of naming the page after the feature, name it after the task it does, so:  [setting-recording-levels-and-playback-levels.md](../../basics/recording-your-voice-and-microphone/setting-recording-levels-and-playback-levels.md "mention")
+To combat this, try to write your guides as a way towards a goal, or a **task**. The above example, instead of naming the page after the feature, name it after the task it does, so:  [setting-recording-levels-and-playback-levels.md](../../../basics/recording-your-voice-and-microphone/setting-recording-levels-and-playback-levels.md "mention")
 
-Tasks aren't necessarily tied to individual features. For example, [noise-reduction-removal.md](../../repairing-audio/noise-reduction-removal.md "mention") can talk about several tools as once as they all are means towards a common goal. 
+Tasks aren't necessarily tied to individual features. For example, [noise-reduction-removal.md](../../../repairing-audio/noise-reduction-removal.md "mention") can talk about several tools as once as they all are means towards a common goal. 
 
 If a feature has many different modes or options that are unrelated to the task you're describing, avoid making long lists of what all the feature can do. Focus on the task-related ones instead.
 
@@ -34,7 +34,7 @@ Audacity's user base consists largely of **casual users**. As such, you can't ex
 
 For example, if you write a guide about compressing and expanding audio, you don't need to hold yourself up on explaining what a compressor is, since the only people who'll ever end up reading that guide are people who already know about that. However, if you were to mention a compressor on a page about general audio editing, you would need to explain what a compressor is good for.
 
-That said: If it's possible to describe a feature without needing to resort to lingo, use it even if it's slightly less accurate. For example, "punch-in repair" would be the accurate term for [re-recording-a-section.md](../../repairing-audio/re-recording-a-section.md "mention"), but also is way harder to understand and thus to find.
+That said: If it's possible to describe a feature without needing to resort to lingo, use it even if it's slightly less accurate. For example, "punch-in repair" would be the accurate term for [re-recording-a-section.md](../../../repairing-audio/re-recording-a-section.md "mention"), but also is way harder to understand and thus to find.
 
 ### Scope
 

community/contributing/tutorials/todo/using-macros-to-automate-frequent-tasks.md

@@ -12,9 +12,9 @@ description: >-
 
 *   **Batch processing**: Apply one or more effects to multiple audio files and export the processed audio into a new file.
 
-    To use this select the **Apply Macro to:** Files... button in the [Macros Palette](../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) or the [Manage Macros](../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) dialog.
+    To use this select the **Apply Macro to:** Files... button in the [Macros Palette](../../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) or the [Manage Macros](../../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) dialog.
 
-    For more detail on batch processing please see [**this page**](../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md#files...).
+    For more detail on batch processing please see [**this page**](../../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md#files...).
 * **Effects automation**: where the [selected audio](https://manual.audacityteam.org/man/audacity\_selection.html) in the [track](https://manual.audacityteam.org/man/audio\_tracks.html) or tracks in the current project is subjected to the same prescribed sequence of effects, and optionally, a file exported from the entire audio.
 
 {% hint style="info" %}
@@ -27,33 +27,33 @@ Macros can contain Select commands to make their own selections as the Macro run
 
 You can manage and apply Macros using the [Tools Menu](https://manual.audacityteam.org/man/tools\_menu.html):
 
-* **Tools > Macros...** to manage Macros: [to create, edit and test](../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) them
-* **Tools > Apply Macro > Palette...** for a [toolbox of Macros](../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md)
+* **Tools > Macros...** to manage Macros: [to create, edit and test](../../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) them
+* **Tools > Apply Macro > Palette...** for a [toolbox of Macros](../../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md)
 * **Tools > Apply Macro >** _named Macro_ to [apply one named Macro](https://manual.audacityteam.org/man/tools\_menu\_apply\_macro.html)
 
-There are some [**examples of Macros**](../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-examples.md) and tips on using them.
+There are some [**examples of Macros**](../../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-examples.md) and tips on using them.
 
-### [Manage Macros](../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md)
+### [Manage Macros](../../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md)
 
 Use **Tools > Macros...** if you need to create a new Macro or to edit an existing Macro.
 
-![The left side pane displays existing macros and the right pane list the steps for the selected macro](<../../../.gitbook/assets/Manage Macros.png>)
+![The left side pane displays existing macros and the right pane list the steps for the selected macro](<../../../../.gitbook/assets/Manage Macros.png>)
 
-### [Macros Palette](../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) dialog
+### [Macros Palette](../../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) dialog
 
-Use the **Shrink** button to show a reduced [Macros Palette](../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) dialog which lists the existing Macros.
+Use the **Shrink** button to show a reduced [Macros Palette](../../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) dialog which lists the existing Macros.
 
 This dialog is also available directly via **Tools > Apply Macro > Palette...**
 
 ![Macros Palette showing several user-added Macros as well as the as-shipped MP3 Conversion and Fade Ends Macros](https://manual.audacityteam.org/m/images/2/20/macrospalette.png)
 
 {% hint style="info" %}
-Click **Expand** on the [Macros Palette](../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) to return to the full [Manage Macros](../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) dialog.
+Click **Expand** on the [Macros Palette](../../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) to return to the full [Manage Macros](../../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) dialog.
 {% endhint %}
 
 #### Apply Macro to
 
-Both the [Manage Macros](../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) dialog and the [Macro Palette](../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) dialog have **Apply Macro to** buttons:
+Both the [Manage Macros](../../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) dialog and the [Macro Palette](../../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) dialog have **Apply Macro to** buttons:
 
 * **Project** applies the selected Macro to the current project.
 * **Files...** applies the selected Macro to selected external audio files that are in a single directory.
@@ -62,7 +62,7 @@ Both the [Manage Macros](../../../audio-editing/splitting-a-recording-into-separ
 It is recommended not to process more than **500** files at a time.
 {% endhint %}
 
-For more details see the [Macros Palette](../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) page.
+For more details see the [Macros Palette](../../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-palette.md) page.
 
 ### Macro Command Parameters
 
@@ -78,13 +78,13 @@ Also note carefully that settings used in Macros will not affect or change the l
 Basically to paraphrase: _"What happens in Macros stays in Macros"_.
 {% endhint %}
 
-Please see [Manage Macros](../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) for more details.
+Please see [Manage Macros](../../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) for more details.
 
 ### Sharing a Macro
 
-You can export a Macro as a TXT file using the Export button in [Manage Macros](../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) and send it to another user, or copy it to another computer for use there
+You can export a Macro as a TXT file using the Export button in [Manage Macros](../../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md) and send it to another user, or copy it to another computer for use there
 
-You can import another user's Macro, or a copied macro of your own, into your Macros folder by using the Import button in [Manage Macros](../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md).
+You can import another user's Macro, or a copied macro of your own, into your Macros folder by using the Import button in [Manage Macros](../../../../audio-editing/splitting-a-recording-into-separate-tracks/manage-macros.md).
 
 {% hint style="info" %}
 You can also edit Exported Macros with a text editor and Import them back in if required.
@@ -107,4 +107,4 @@ In order to see the **Macros** folder on Windows, macOS or GNU/Linux, you must s
 
 ### Macros Examples
 
-See the [Macros Examples](../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-examples.md) page for examples of using Macros
+See the [Macros Examples](../../../../audio-editing/splitting-a-recording-into-separate-tracks/macros-examples.md) page for examples of using Macros

repairing-audio/re-recording-a-section.md

@@ -41,7 +41,7 @@ If your audio recording broke at one specific point in time (for example because
 
 To use it: 
 
-1. Select the bad part of the recording and silence it. You can do this by clicking the ![](<../.gitbook/assets/image (12).png>) **Silence Audio Selection** button (found next to the _undo_ and _cut/copy/paste_ buttons), or by pressing `Ctrl+L` (`Cmd+L`)
+1. Select the bad part of the recording and silence it. You can do this by clicking the ![](../.gitbook/assets/Trim.png) **Silence Audio Selection** button (found next to the _undo_ and _cut/copy/paste_ buttons), or by pressing `Ctrl+L` (`Cmd+L`)
 2.  Select a couple of seconds of audio before and after the bad part. With overdubbing turned on, recording will playback the recording back to you and help you match the timing.
 
     ![](<../.gitbook/assets/bad section.png>)

repairing-audio/removing-clicks-pops.md

@@ -31,4 +31,4 @@ The Repair effect can be used to repair short clicks. To use it:
 
 ## Silencing the section
 
-In most cases, having brief amounts of silence is preferable to loud clicks, so completely muting clicks is a valid strategy if other methods fail. For this, simply select the click and press the ![](<../.gitbook/assets/silence icon.png>) **Silence button** (Shortcut: `Ctrl+L` / `Cmd+L`).
+In most cases, having brief amounts of silence is preferable to loud clicks, so completely muting clicks is a valid strategy if other methods fail. For this, simply select the click and press the ![](<../.gitbook/assets/image (12).png>) **Silence button** (Shortcut: `Ctrl+L` / `Cmd+L`).

todo/downloading-and-installing-audacity.md

@@ -5,7 +5,7 @@ description: >-
   the download & installation process.
 ---
 
-# Downloading & Installing Audacity
+# Downloading & installing Audacity
 
 {% tabs %}
 {% tab title="Windows" %}
@@ -17,9 +17,9 @@ Audacity is available from the [Microsoft Store](https://apps.microsoft.com/stor
 * Click **Get in Store App**.\
   ![](<../.gitbook/assets/Microsoft Store Website.png>)
 * The Microsoft Store app will open. Click **Install** to install Audacity.\
-  ![](<../.gitbook/assets/image (15).png>)
+  ![](<../.gitbook/assets/msstore install prompt.png>)
 * When Windows asks you if the installer may make changes to the system, click **Yes**.\
-  ![](<../.gitbook/assets/image (18).png>)
+  ![](<../.gitbook/assets/microsoft windows UAC.png>)
 
 Audacity is now installed. You can start Audacity from the start menu.
 
@@ -34,7 +34,7 @@ Audacity is now installed. You can start Audacity from the start menu.
 ![Windows 11 warning when running Audacity installer](<../.gitbook/assets/Windows 11 - Microsoft-verified app warning.png>)
 
 * When Windows asks you if the installer may make changes to the system, click **Yes**.\
-  ![](<../.gitbook/assets/image (18).png>)
+  ![](<../.gitbook/assets/microsoft windows UAC.png>)
 * Select the language to use during the installation and click **OK**.
 
 ![Select the language to use during the installation](<../.gitbook/assets/Select Setup Language.png>)
@@ -83,7 +83,7 @@ Audacity is now installed. You can start Audacity from the start menu.
 
     * You can also drag Audacity out of the DMG to any other location. You need the administrator password to copy Audacity to "Applications".
 
-    <img src="../.gitbook/assets/Screen Shot 2022-05-02 at 5.18.41 PM (1).png" alt="" data-size="original">
+    <img src="../.gitbook/assets/Audacity Mac Install (1).png" alt="" data-size="original">
 * Launch Audacity.app from /Applications or from your chosen location.\
   **Note:** Do not double-click the "Audacity" icon in the DMG to launch Audacity from there.
 *   Once the program has opened press "OK" to start editing!

troubleshooting/solving-other-problems.md

@@ -1,11 +1,5 @@
 # Solving other problems
 
-
-
-* [ ] no sound
-* [ ] invalid samplerate
-* [ ] error codes / error opening device
-
 ## Can't open an MP3 file
 
 If you see an error when importing an MP3 file, it can have the following causes: 

troubleshooting/solving-recording-problems/README.md

@@ -1,7 +1,5 @@
 # Solving recording problems
 
-* [ ] [https://alphamanual.audacityteam.org/man/FAQ:Recording\_-\_Troubleshooting](https://alphamanual.audacityteam.org/man/FAQ:Recording\_-\_Troubleshooting)
-
 ## Error opening sound device / Error opening recording device
 
 This error indicates a problem with the hardware, whether it is permissions, drivers, connections, or if you ask the device to do something it cannot do