add an entry in antora/modules/ROOT/nav.adoc add an entry in samples/{category}/README.adoc, if possible with some error generating code, or asking the user for some ...