The recently introduced management command makes customising easier, and the docs have been updated accordingly. The how-tos could still do with updating to the new command, but at least the main docs are current.
It's such a core concept, it deserves a dedicated document. Moved some of the "why" from the how-to into it as well.