I have grown the habit of copy-pasting and adjusting my go-to folder structure and _template.html file whenever i create docs for a new project.
However, i can understand new users being confused by the actual setup process, as you have to create a folder structure with multiple files by hand. I think it is reasonable for a tool such as fsdocs to provide a single command that initializes the necessary folder structure for the documentation folder.
For this, i suggest the addition of a fsdocs init command, which could have flags for also adding other templates, e.g., _template.ipynb, as well as svg files for download notebook or download script links (see for example here on the top of the page)
This could also be used for some automated SEO tags, see #869 (there is a default template, which should be adjusted and created by this init command)
I have grown the habit of copy-pasting and adjusting my go-to folder structure and
_template.htmlfile whenever i create docs for a new project.However, i can understand new users being confused by the actual setup process, as you have to create a folder structure with multiple files by hand. I think it is reasonable for a tool such as
fsdocsto provide a single command that initializes the necessary folder structure for the documentation folder.For this, i suggest the addition of a
fsdocs initcommand, which could have flags for also adding other templates, e.g.,_template.ipynb, as well as svg files fordownload notebookordownload scriptlinks (see for example here on the top of the page)This could also be used for some automated SEO tags, see #869(there is a default template, which should be adjusted and created by this init command)