The overall project structure looks something like this:
The main folder contains:
css: four css files (for iframe and primary content) within a folder.
developer: content that is only visible in developer mode.
documents: actual user-relevant documents.
They can contain subfolders for chapters in case there are too many files. They also have an index page (the document title page).
One single file (_content.html) holds all navigational links to documents, chapters and subchapters.
favicon, fonts: shared resources
images: images are shared resources and as a proposal, they are organized thematically - with no association to a specific document or chapter.
js: four javascript files (organized similar to css files)
In the main folder, there is the main index landing page, the noscript fallback and a subpage for displaying the menu content (Documents, Settings).
The procedure requires the author to create a new "document" folder and corresponding html pages in the ./documents folder. To got startet fast and easy, just clone the ./developer/template folder (Template Document). The minimal required HTML for the title and chapter pages and an overview of usable components is provided.
The next necessary step is to provide links in the ./documents/_content.html file, following the given hirarchy. In order for this to work, path attributes are used. The path of this page is root/man-developer/03-structure-and-components. Sections in the _content.html file will translate this path step by step. Javascript resolves that path and determines, which document and chapter links will be shown. The path size is arbitrary, but should not be too big. It has to be unique between all documents, chapters and subchapters.
Once the document and it's first chapter exists, the process of adding more chapters is more or less copy-paste action. The inner organization does not follow a specific rule. It mainly depends on the document size and number of files. Long single pages are possible (but not always practical) as well as large amounts of files (possibly within subfolders).
File- and folder names should not contain spaces.
Other possible resources like images may be added to the shared ./images folder or fitting subfolder.
[tbc]