beets/docs
Johann Fot 306211a4c8 Add native support for multiple genres per album/track
Simplify multi-genre implementation based on maintainer feedback (PR #6169).

Changes:
- Remove multi_value_genres and genre_separator config options
- Replace complex sync_genre_fields() with ensure_first_value('genre', 'genres')
- Update all plugins (Beatport, MusicBrainz, LastGenre) to always write genres as lists
- Add automatic migration for comma/semicolon/slash-separated genre strings
- Add 'beet migrate genres' command for explicit batch migration with --pretend flag
- Update all tests to reflect simplified approach (44 tests passing)
- Update documentation

Implementation aligns with maintainer vision of always using multi-value genres
internally with automatic backward-compatible sync to the genre field via
ensure_first_value(), eliminating configuration complexity.

Migration strategy avoids problems from #5540:
- Automatic lazy migration on item access (no reimport/mbsync needed)
- Optional batch migration command for user control
- No endless rewrite loops due to proper field synchronization
2025-12-28 17:23:50 +01:00
..
_static Transparent background logo for docs 2023-10-29 10:30:33 +01:00
_templates/autosummary A number of smaller additions. 2025-09-04 12:49:43 +01:00
api Add index for API Reference 2025-09-04 12:49:48 +01:00
dev Move PromptChoice to beets.util module 2025-12-02 01:51:14 +00:00
extensions Add Sphinx extension for configuration value documentation 2025-10-19 01:34:32 +01:00
guides Update python version references 2025-11-08 12:09:52 +00:00
plugins Make musicbrainzngs dependency optional and requests required 2025-12-20 01:35:52 +00:00
reference Add album template value in ftintitle plugin 2025-11-21 18:31:59 +01:00
.gitignore Streamlined auto api referencing for documentation (#5795) 2025-05-22 11:35:40 +02:00
changelog.rst Add native support for multiple genres per album/track 2025-12-28 17:23:50 +01:00
code_of_conduct.rst Update docstrfmt 2025-09-04 12:49:44 +01:00
conf.py Add Sphinx extension for configuration value documentation 2025-10-19 01:34:32 +01:00
contributing.rst Update docstrfmt 2025-09-04 12:49:44 +01:00
faq.rst Run formatter. 2025-10-11 13:52:35 +02:00
index.rst Re-added macport instructions. Removed mailing list ref. Added section 2025-10-11 13:52:35 +02:00
Makefile Streamlined auto api referencing for documentation (#5795) 2025-05-22 11:35:40 +02:00
modd.conf Switch to modd for live docs build 2017-12-21 11:39:08 -05:00
team.rst Reformat all docs using docstrfmt 2025-08-10 16:25:05 +01:00