Updated Write Tags (markdown)

Write-Metadata-to-Audio-Files.md

@@ -0,0 +1,23 @@
+## Overview
+
+Lidarr can write metadata for matched tracks to the audio file (e.g. ID3 tags).  This data contains the track title, artist track number etc. as well as MusicBrainz identifiers.  The result should be similar to that of [MusicBrainz Picard](https://picard.musicbrainz.org/), though we currently don't populate all of the fields that Picard does.
+
+## Options
+
+By default, tag writing is disabled.  The available options are described below.
+
+### Never
+The default.  Lidarr will never alter the files on disk.
+
+### For new downloads only
+Lidarr will only write tags to files when they are first matched and are not already in your library.  This will not alter files that are already in your library directory even when they are matched for the first time
+
+### For all files; initial import only
+Lidarr will write tags to files the first time they are matched i.e. for new downloads and files already in your library.
+
+### For all files; keep in sync with MusicBrainz
+Lidarr will write tags to all files and update the tags to track any changes in MusicBrainz
+
+### Scrub Existing Tags
+If this option is disabled, Lidarr will set the tags it has data for and leave any other existing tags unchanged.  If this option is enabled, then Lidarr will remove any tags it has not set itself.
+

Write-Tags.md

@@ -1 +0,0 @@
-Placeholder