My preference would be to have the documentation for the template easy to find in a myst book that is deployed based on the source code in example/. this guarantees that the features are working (based on GHA workflow), and also illustrates the use case explicitly.
@FreekPols do you have an opinion?