# Folder structure

Zero or minimal configuration is a real thing. But what is not understood immediately is that to allow no configuration, some assumptions must be made. Those assumptions are what lead to an opinionated usage and also the reason why we have so many standards and frameworks that in essense do the exact same thing. I have tried to make direct the option as little as possible but its hard to capture all usecases right from the start.

# Include a Readme.md in each folder

Have a main Readme.md file for each folder. This will allow you to add a short description for each folder, but also can be used as an Overview page. This is needed by the plugin to be able to show a page if you navigate to that folder's url, or else you will get a 404.

# Sorting order

The sort order is assumed to be alphabetically based on the filename. If you want a document to appear before an other, you can try a numbering system in the filename, for example:

1-known-issues.md
2-disclaimer.md