Move templates to the data directory and add readmes

Author: Marek Suchánek

data/generated/README.md

@@ -0,0 +1,4 @@
+# generated
+
+This directory contains static, fully generated module files created by a released version of `newdoc`. These files serve mainly as test targets to check that `newdoc` continues to generate the exact same output.
+

data/templates/README.md

@@ -0,0 +1,6 @@
+# templates
+
+This directory contains the templates that `newdoc` uses at runtime to generate new files.
+
+The templates are AsciiDoc files with additional directives for `newdoc` to replace certain parts of the content with generated text. Currently, the directives do not comply to any templating standard, and instead, they are simple replaceable strings.
+

templates/assembly.adoc data/templates/assembly.adoctemplates/assembly.adoc renamed to data/templates/assembly.adoc

@@ -36,10 +36,10 @@ pub struct Module {
 }
 
 // Load the AsciiDoc templates at build time
-const ASSEMBLY_TEMPLATE: &str = include_str!("../templates/assembly.adoc");
-const CONCEPT_TEMPLATE: &str = include_str!("../templates/concept.adoc");
-const PROCEDURE_TEMPLATE: &str = include_str!("../templates/procedure.adoc");
-const REFERENCE_TEMPLATE: &str = include_str!("../templates/reference.adoc");
+const ASSEMBLY_TEMPLATE: &str = include_str!("../data/templates/assembly.adoc");
+const CONCEPT_TEMPLATE: &str = include_str!("../data/templates/concept.adoc");
+const PROCEDURE_TEMPLATE: &str = include_str!("../data/templates/procedure.adoc");
+const REFERENCE_TEMPLATE: &str = include_str!("../data/templates/reference.adoc");
 
 /// Construct a basic builder for `Module`, storing information from the user input.
 impl Input {