feat(mkdocs): mkdocs generator works now

It can be selected for each type of program we want to build, and makes
sense for everything that is not a library.

We also tried to unify names and folders a bit more, even though there
certainly is more work to be done to be fully non-redundant.

Fixes #43

etc/api/shared.yaml

@@ -16,6 +16,8 @@ directories:
   api_base: etc/api
   # all mako source files
   mako_src: src/mako
+  # The subdirectory to contain documentation from all APIs and related programs
+  doc_subdir: doc
 cargo:
   build_version: "0.1.1"
   repo_base_url: https://github.com/Byron/google-apis-rs

etc/api/type-api.yaml

@@ -17,6 +17,7 @@ make:
   aggregated_target_suffix: -api
   depends_on_suffix:
   global_targets: Yes
+  documentation_engine: rustdoc
   templates:
     # all output directories are relative to the one set for the respective API
     - source: README.md

etc/api/type-cli.yaml

@@ -1,12 +1,19 @@
+mkdocs:
+  ## A directory to bring us from the mkdocs invocation directory to the gen-root
+  gen_root_dir: ..
+  site_dir: build_html
 make:
   id: cli
   target_name: CLIs
   target_suffix: -cli
   aggregated_target_suffix: -cli
   depends_on_suffix: ''
+  documentation_engine: mkdocs
   templates:
     - source: ../LICENSE.md
     - source: ../Cargo.toml
+    - source: mkdocs.yml
+    - source: README.md
     - source: main.rs
       output_dir: src
 cargo: