Overhaul end user documentation

docs/user_documentation/queue/add_album.md

@@ -0,0 +1,32 @@
+# Add albums to your queue
+
+Add entire albums to your queue to start listening to them. Choose from the following __Play options__:
+
+- __Play__ – remove all content from the queue and play the selected album.
+- __Add to queue__ – add the selected album to the end of the queue.
+- __Play next__ – add the selected album to the next position in the queue.
+- __Play now__ – play the selected album immediately but do not clear the queue.
+
+You can add albums from the following places:
+
+```{contents}
+:local:
+```
+
+## From the album details page
+
+To add an album to the queue from the album details page:
+
+1. Go to the album's details page.
+2. Select the orange play button ({fa}`play`) to __Play__ the album. Select the dropdown icon ({fa}`caret-down`) to select a different __Play option__.
+
+You're done! You've added the album to your queue.
+
+## From an album card
+
+To add an album from its album card:
+
+1. Find the album card in the interface.
+2. Select the orange play button ({fa}`play`) to __Play__ the album. Select the kebab menu ({fa}`ellipsis-v`) to select a different __Play option__.
+
+That's it! You've added the album to your queue.

docs/user_documentation/queue/add_artist.md

@@ -0,0 +1,32 @@
+# Add artist discographies to your queue
+
+Add an artist's entire discography to your queue to start listening to it. Choose from the following __Play options__:
+
+- __Play__ – remove all content from the queue and play the artist's discography.
+- __Add to queue__ – add the selected artist's discography to the end of the queue.
+- __Play next__ – add the selected artist's discography to the next position in the queue.
+- __Play now__ – play the artist's discography immediately but do not clear the queue.
+
+You can add an artist's discography from the following places:
+
+```{contents}
+:local:
+```
+
+## From the artist details page
+
+To add an artist's discography to the queue from the artist details page:
+
+1. Go to the artist's details page.
+2. Select the orange play button ({fa}`play`) to __Play__ the album. Select the {guilabel}`More…` to select a different __Play option__.
+
+You're done! You've added the artist's discography to your queue.
+
+## From an artist card
+
+To add an artist's discography from their artist card:
+
+1. Find the artist card in the interface.
+2. Select the orange play button ({fa}`play`) to __Play__ the album. Select the kebab menu ({fa}`ellipsis-v`) to select a different __Play option__.
+
+That's it! You've added the artist's discography to your queue.

docs/user_documentation/queue/add_playlist.md

@@ -0,0 +1,32 @@
+# Add playlists to your queue
+
+Add entire playlists to your queue to start listening to them. Choose from the following __Play options__:
+
+- __Play__ – remove all content from the queue and play the selected playlist.
+- __Add to queue__ – add the selected playlist to the end of the queue.
+- __Play next__ – add the selected playlist to the next position in the queue.
+- __Play now__ – play the selected playlist immediately but do not clear the queue.
+
+You can add playlists from the following places:
+
+```{contents}
+:local:
+```
+
+## From the playlist details page
+
+To add an playlist to the queue from the playlist details page:
+
+1. Go to the playlist's details page.
+2. Select {guilabel}`Play all` to __Play__ the playlist. Select the dropdown icon ({fa}`caret-down`) to select a different __Play option__.
+
+You're done! You've added the playlist to your queue.
+
+## From an playlist card
+
+To add an playlist from its playlist card:
+
+1. Find the playlist card in the interface.
+2. Select the orange play button ({fa}`play`) to __Play__ the playlist. Select the kebab menu ({fa}`ellipsis-v`) to select a different __Play option__.
+
+That's it! You've added the playlist to your queue.

docs/user_documentation/queue/add_series.md

@@ -0,0 +1,15 @@
+# Add series to your queue
+
+Add entire series to your queue to start listening to them. Choose from the following __Play options__:
+
+- __Play__ – remove all content from the queue and play the selected series.
+- __Add to queue__ – add the selected series to the end of the queue.
+- __Play next__ – add the selected series to the next position in the queue.
+- __Play now__ – play the selected series immediately but do not clear the queue.
+
+To add a series to the queue from the album details page:
+
+1. Go to the series' details page.
+2. Select the orange play button ({fa}`play`) to __Play__ the series. Select the dropdown icon ({fa}`caret-down`) to select a different __Play option__.
+
+You're done! You've added the series to your queue.

docs/user_documentation/queue/add_tracks.md

@@ -0,0 +1,15 @@
+# Add tracks to your queue
+
+Add tracks to your queue to start listening to them. Choose from the following __Play options__:
+
+- __Play__ – remove all content from the queue and play the selected track.
+- __Add to queue__ – add the selected track to the end of the queue.
+- __Play next__ – add the selected track to the next position in the queue.
+- __Play now__ – play the selected track immediately but do not clear the queue.
+
+To add a track to the queue:
+
+1. Find your track in a track table.
+2. Select the orange play button ({fa}`play`) to __Play__ the track. Select the kebab menu ({fa}`ellipsis-v`) to select a different __Play option__.
+
+That's it! You've added the track to your queue.

docs/user_documentation/queue/index.md

@@ -0,0 +1,21 @@
+# Queue
+
+Use the audio queue to manage audio playback. You can add tracks, albums, series, artist discographies, and playlists to your queue.
+
+Follow the guides in this section to get started.
+
+```{toctree}
+---
+caption: Manage your queue
+maxdepth: 1
+---
+
+add_tracks
+add_album
+add_series
+add_artist
+add_playlist
+rearrange_content
+remove_content
+
+```

docs/user_documentation/queue/rearrange_content.md

@@ -0,0 +1,14 @@
+# Rearrange content in your queue
+
+```{note}
+Rearranging content is currently only supported on the desktop.
+```
+
+You can change the order of content in your queue at any time. To do this:
+
+1. Select the up arrow ({fa}`caret-up`) on the queue menu to expand the queue.
+2. Pick up tracks by selecting the grip lines on the left. Your mouse pointer shows a hand ({fa}`hand-grab-o`).
+3. Drop the tracks in their new position in the queue.
+4. Select {guilabel}`Close` to close the queue.
+
+That's it! You've rearranged the content in your queue.

docs/user_documentation/queue/remove_content.md

@@ -0,0 +1,52 @@
+# Remove content from your queue
+
+```{note}
+If you remove the currently playing track, the next item in the queue plays. If you remove all items, the queue closes.
+```
+
+You can remove content from your queue at any time. You can choose between the following options:
+
+```{contents}
+:local:
+```
+
+## Remove individual tracks from the queue
+
+To remove individual tracks from the queue:
+
+```{tabbed} Desktop
+
+1. Select the up arrow ({fa}`caret-up`) on the queue menu to expand the queue.
+2. Select the delete icon ({fa}`times`) next to the track you want to remove.
+
+```
+
+```{tabbed} Mobile
+
+1. Select the player bar at the bottom of the screen to expand the player.
+2. Select the up arrow ({fa}`caret-up`) on the queue menu to expand the queue.
+3. Select the delete icon ({fa}`times`) next to the track you want to remove.
+
+```
+
+That's it! You've removed tracks from your queue.
+
+## Remove all content from the queue
+
+To remove all content from your queue at once:
+
+```{tabbed} Desktop
+
+1. Select the up arrow ({fa}`caret-up`) on the queue menu to expand the queue.
+2. Select {guilabel}`Clear` to remove all content from the queue.
+
+```
+
+```{tabbed} Mobile
+
+1. Select the player bar at the bottom of the screen to expand the player.
+2. Select the up arrow ({fa}`caret-up`) on the queue menu to expand the queue.
+3. Select {guilabel}`Clear` to remove all content from the queue.
+```
+
+That's it! You've removed all content from your queue.