« get me outta code hell

hsmusic-docs - Unnamed repository; edit this file 'description' to name the repository.
about summary refs log tree commit diff
path: root/documents/art-tag.md
diff options
context:
space:
mode:
Diffstat (limited to 'documents/art-tag.md')
-rw-r--r--documents/art-tag.md4
1 files changed, 3 insertions, 1 deletions
diff --git a/documents/art-tag.md b/documents/art-tag.md
index fbfaf7e..cb932f8 100644
--- a/documents/art-tag.md
+++ b/documents/art-tag.md
@@ -1,10 +1,12 @@
 # Art Tag Format
 
+> Art tags are added to albums' and tracks' art to make locating artworks with similar features easy. They're also used to apply sensitive content warnings to certain works, which makes covers show a notice and take a click before the artwork is revealed. Art tags are a very simple system, so they can be used to tag just about anything — on HSMusic we tag mostly specific characters, animal species, and settings. If you're adding a new album with lots of art, it's a good idea to [learn about tagging artwork for HSMusic.](../guidelines/art-tags.md)
+
 Art tag documents are stored all in one file, `tags.yaml`, one document (entry) per tag.
 
 ## Art tag documents
 
-Referenced as `tag:directory`.
+Referenced as `tag:directory` or by name.
 
 * `Tag`: art tag name
 * `Directory`: unique identifier among other art tags