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 ... ^^

Reboot docs with new search, page nav, design refresh and much updated content · e606eeb8ec

faircamp - A static site generator for audio producers

Codeberg.org
@freebliss I'm still using 1.5 for building *very* slowly my #SubTerraLabel, hope I'll have time to study what's new. 😅
@myrornaskrig no hurry at all :) it's anyhow still a few months until 2.0 even lands (September according to the plan). :)