How to organize markdown files on disk
Markdown files should be organized by language and then by their position in the table of contents.
The top folder structure should always be the language:
/docs
|- en
|- jp
|- ko
|- images
|- all_langs
\- _data
- All english documentation should be in the
enfolder. - All japanese documentation should be in the
jpfolder. - All korean documentation should be in the
kofolder. - Images are shared across languanges and are stored in an
imagesfolder. - If you have content that is shared across languages (such as pdfs or zips for example), create an
all_langsfolder and organize it there. - Special TOC and landing page data is stored inside the
_datafolder.
Symmetry : The language folders and the image folder should all have the exact same folder structure. This makes translation easy.
Inside the en folder, items should be organized as they are in the table of contents.
/root-folder
|- index.md
|- shotgun.md
|- shotgun
| \- event-daemon.md
\- toolkit.md