Permalink
Browse files

Merge pull request #763 from wilr/disqus/docsexplaination

Add reference to documentation directory structure
  • Loading branch information...
2 parents c4b0c0e + b99c9e8 commit 5d6e1f8bf19f561084015cf0dcbb91e9d5be99e8 @simonwelsh simonwelsh committed Sep 2, 2012
Showing with 24 additions and 0 deletions.
  1. +24 −0 docs/en/topics/directory-structure.md
@@ -51,6 +51,30 @@ Example Forum:
![](_images/modules_folder.jpg)
+### Module documentation
+
+Module developers can bundle developer documentation with their code by producing
+plain text files inside a 'docs' folder located in the module folder. These files
+can be written with the Markdown syntax (See ["Writing Documentation"](/misc/contributing#writing-documentation))
+and include media such as images or videos.
+
+Inside the docs folder, developers should organize the markdown files into each
+separate language they wish to write documentation for (usually just `en`). Inside
+each languages' subfolder, developers then have freedom to create whatever structure
+they wish for organizing the documentation they wish.
+
+Example Forum Documentation:
+
+ | Directory | Description |
+ | --------- | ----------- |
+ | `forum/docs` | The docs folder will be picked up by the documentation viewer. |
+ | `forum/docs/_manifest_exclude` | Empty file to signify that SilverStripe does not need to load classes from this folder |
+ | `forum/docs/en/` | English documentation |
+ | `forum/docs/en/index.md` | Documentation homepage. Should provide an introduction and links to remaining docs |
+ | `forum/docs/en/installing.md` | |
+ | `forum/docs/en/_images/` | Folder to store any images or media |
+ | `forum/docs/en/sometopic/` | You can organize documentation into nested folders |
+
## PHP Include Paths

0 comments on commit 5d6e1f8

Please sign in to comment.