When you a contributing to the Umbraco documentation it can be useful to know how we structure directories, files and images.
In this article you will get an overview of the file structure as well as a few best-practices for naming files.
The overall structure of the Umbraco documenation is divided by product. Each Umbraco product has its own directories with articles and images.
Diving one step deeper, each individual topic is contained in its own directory.
Each directory must have a
README.mdfile which will act as a landing page for that directory. If images are used, these must be in an
imagesdirectory next to the
.mdfile referencing them using relative paths.
All file and directory names need to be small-caps in order to be synced properly with GitBook.
If an article is not a landing page, we recommend using the title of the article as the file name.
Images are stored and linked using relative paths to .md pages, and should by convention always be in an
imagesdirectory. To add an image to
/documentation/reference/partials/renderviewpage.mdyou link it like so:
![My Image Alt Text](images/img.png)
And store the image as
Images can have a maximum width of 800px. Please always try to use the most efficient compression,