Purpose
Currently, there is only a single root folder for documentation and there is zero support for localization. This is bad. Root folder limitations lead to organizational issues and a lack of localization harms accessibility.
Solution
Implementing directory navigation and localization is simple enough, and most of the actual implementation is code-wise and should be handled at Steviegt6/Tomatophile. For brevity's sake, I will detail the entire concept here.
Directories
Each folder will be labeled as a "directory", and these directories only hold a single piece of actual information: their names.
Say we have a folder called directory-one
, and an article called article-one
that should go in directory-one
. The structure would be: directory-one/article-one/files-go-here.md
. This allows for simple organization.
Localization
Building on top of directories, languages should be specified using {langkey}.md
. We can do this since we decoupled article markdown page names from actual markdown files by instead naming directories.
Example:
directory-one/article-one/en-US.md
.