From ae8872d51e2cb3aa4acea523e0261ccdd5ae4976 Mon Sep 17 00:00:00 2001
From: "Dustin J. Mitchell" <dustin@mozilla.com>
Date: Sat, 21 Nov 2020 19:41:36 -0500
Subject: [PATCH 1/2] add an mdbook

---
 .taskcluster.yml                    | 27 +++++++++++++++++++++++++++
 docs/.gitignore                     |  1 +
 docs/README.md                      |  3 +++
 docs/book.toml                      |  6 ++++++
 docs/src/SUMMARY.md                 |  3 +++
 docs/{ => src}/development-notes.md |  0
 6 files changed, 40 insertions(+)
 create mode 100644 docs/.gitignore
 create mode 100644 docs/README.md
 create mode 100644 docs/book.toml
 create mode 100644 docs/src/SUMMARY.md
 rename docs/{ => src}/development-notes.md (100%)

diff --git a/.taskcluster.yml b/.taskcluster.yml
index 37cb4a98f..5f7883c74 100644
--- a/.taskcluster.yml
+++ b/.taskcluster.yml
@@ -44,3 +44,30 @@ tasks:
           description: Run tests for taskchampion
           owner: dustin@v.igoro.us
           source: ${repo_url}
+    - $if: run
+      then:
+        provisionerId: 'proj-misc'
+        workerType: 'ci'
+        deadline: {$fromNow: '1 hour'}
+        expires: {$fromNow: '1 day'}
+        payload:
+          maxRunTime: 3600
+          image: rust:latest
+          command:
+            - /bin/bash
+            - '-c'
+            - >-
+              git clone ${repo_url} repo &&
+              cd repo && 
+              git config advice.detachedHead false &&
+              git checkout ${ref} &&
+              cd docs &&
+              curl -L --compressed https://github.com/rust-lang/mdBook/releases/download/v0.4.4/mdbook-v0.4.4-x86_64-unknown-linux-gnu.tar.gz | gunzip -c | tar -xf - &&
+              chmod +x mdbook &&
+              ./mdbook test &&
+              ./mdbook build
+        metadata:
+          name: taskchampion-book
+          description: Verify that the docs build with mdbook
+          owner: dustin@v.igoro.us
+          source: ${repo_url}
diff --git a/docs/.gitignore b/docs/.gitignore
new file mode 100644
index 000000000..7585238ef
--- /dev/null
+++ b/docs/.gitignore
@@ -0,0 +1 @@
+book
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 000000000..7aaa35c16
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,3 @@
+This is an [mdbook](https://rust-lang.github.io/mdBook/index.html) book.
+Minor modifications can be made without installing the mdbook tool, as the content is simple Markdown.
+Changes are verified on pull requests.
diff --git a/docs/book.toml b/docs/book.toml
new file mode 100644
index 000000000..0e19be438
--- /dev/null
+++ b/docs/book.toml
@@ -0,0 +1,6 @@
+[book]
+authors = ["Dustin J. Mitchell"]
+language = "en"
+multilingual = false
+src = "src"
+title = "TaskChampion"
diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
new file mode 100644
index 000000000..e499e5c62
--- /dev/null
+++ b/docs/src/SUMMARY.md
@@ -0,0 +1,3 @@
+# Summary
+
+- [Development Notes](./development-notes.md)
diff --git a/docs/development-notes.md b/docs/src/development-notes.md
similarity index 100%
rename from docs/development-notes.md
rename to docs/src/development-notes.md

From 17fe90c8d0f12b4eefd7d6b3037fe4cfed9e06dc Mon Sep 17 00:00:00 2001
From: "Dustin J. Mitchell" <dustin@mozilla.com>
Date: Sat, 21 Nov 2020 19:47:40 -0500
Subject: [PATCH 2/2] poor excuse for documentation

---
 docs/src/SUMMARY.md      | 3 +++
 docs/src/installation.md | 3 +++
 docs/src/usage.md        | 4 ++++
 3 files changed, 10 insertions(+)
 create mode 100644 docs/src/installation.md
 create mode 100644 docs/src/usage.md

diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
index e499e5c62..1bfe24c75 100644
--- a/docs/src/SUMMARY.md
+++ b/docs/src/SUMMARY.md
@@ -1,3 +1,6 @@
 # Summary
 
+- [Installation](./installation.md)
+- [Usage](./usage.md)
+---
 - [Development Notes](./development-notes.md)
diff --git a/docs/src/installation.md b/docs/src/installation.md
new file mode 100644
index 000000000..a597a11da
--- /dev/null
+++ b/docs/src/installation.md
@@ -0,0 +1,3 @@
+# Installation
+
+As this is currently in development, installation is by cloning the repository and running "cargo build".
diff --git a/docs/src/usage.md b/docs/src/usage.md
new file mode 100644
index 000000000..39a73fc03
--- /dev/null
+++ b/docs/src/usage.md
@@ -0,0 +1,4 @@
+# Usage
+
+The main interface to your tasks is the `task` command, which supports various subcommands.
+You can find a quick list of all subcommands with `task help`.