Yesterday I wrapped up the initial, biggest part of the docs overhaul for #faircamp 2.0 (https://codeberg.org/simonrepp/faircamp/commit/e606eeb8ec1b3d1300c5ed9febf3d3822d18e04e).
A delightful result of the writing process was how well it reflected what already works or doesn't work in the latest state of 2.0:
For instance, the "links" option was greatly simplified for 99%+ of usecases, but a newly introduced edge case proved to be so absurdly complex to document and understand that I reconsidered the whole thing, and now found another solution that is even simpler than both prior approaches - while completely eliminating the edgecase.
Also, I found that an optional feature I was about to postpone (planning is oh so tight :)) could not possibly be left out, seeing how annoyed I already was while just documenting the inconvenient alternative x) ... so today I started implementing "wildcard settings", which will collaterally enable some niceties that 1.x didn't have, for example:
*.download_formats:
- mp3
- flac
(= configure the available download formats for individual tracks AND entire release downloads in one declaration)
The more pressing need for this in 2.0 is to differentiate default settings at the global level, e.g.:
artist.theme: …
(set the theme for all artists on the site)
v.s.
*.theme: …
(set the theme for the whole site)
Yay! And now back to work ... ^^
