Doc scaffolding

Author: ammario

.sail/Dockerfile

@@ -1,3 +1,6 @@
 FROM codercom/ubuntu-dev-go
 RUN sudo apt-get install -y htop hugo
 LABEL project_root "~/go/src/go.coder.com"
+
+# Modules break much of Go's tooling.
+ENV GO111MODULE=off

config_test.go

@@ -23,8 +23,10 @@ func Test_resolvePath(t *testing.T) {
 		{"Abs", args{"/home/ammar", "/home/ammar/test"}, "/home/ammar/test"},
 		{"NoRel", args{"/home/ammar", wd}, wd},
 	}
+
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
+
 			if got := resolvePath(tt.args.homedir, tt.args.path); got != tt.want {
 				t.Errorf("resolvePath() = %v, want %v", got, tt.want)
 			}

globalflags.go

@@ -17,6 +17,7 @@ func (gf *globalFlags) debug(msg string, args ...interface{}) {
 	if !gf.verbose {
 		return
 	}
+
 	flog.Log(
 		flog.Level(color.New(color.FgHiMagenta).Sprint("DEBUG")),
 		msg, args...,

runcmd.go

@@ -37,6 +37,7 @@ func (c *runcmd) spec() commandSpec {
 
 func (c *runcmd) initFlags(fl *flag.FlagSet) {
 	c.repoArg = fl.Arg(0)
+
 	fl.StringVar(&c.image, "image", "", "Custom docker image to use.")
 	fl.StringVar(&c.hat, "hat", "", "Custom hat to use.")
 	fl.BoolVar(&c.keep, "keep", false, "Keep container when it fails to build.")

site/content/docs/index.md

@@ -5,18 +5,33 @@ browser_title="Sail - Docs - Getting Started"
 +++
 Welcome to the the Sail docs.
 
-## Install Release
+## Install Stable Release
 
+### Linux
+Binary release
 
+dpkg
+
+### MacOS
+
+### Windows
+
+- Linux
+    - amd64
+    - x86
+- MacOS/Darwin
 
 ## Install From Source
 
-To install `sail` for the first time, run:
+To install `sail` the latest version of sail, run:
 
 ```bash
 go install sail.dev
 ```
 
-If you don't have Go installed, you can grab it from here.
+If you don't have Go installed, you can grab it [here](https://golang.org/dl/).
+
+`go install` will install sail to `~/go/bin/sail`.
+
 
 ### Sub

site/themes/sail/assets/doc.scss

@@ -12,14 +12,21 @@ body {
     width: 75%;
 }
 
-ul {
-    padding-inline-start: 25px;
+.content-box {
+    padding-inline-start: 3em;
+}
+
+// Hugo Table of Contents
+// ul {
+//     list-style-type: none;
+//     padding-inline-start: 0;
+// }
+
+nav > ul, nav > ul > li > ul {
     list-style-type: none;
-    color: grey;
+    padding-inline-start: 0;
 }
 
-#TableOfContents > ul {
-    list-style: none;
-    margin: 0;
-    padding: 0;
-}
+#TableOfContents > li {
+    padding-inline-start: 25px;
+}

site/themes/sail/assets/main.scss

@@ -3,10 +3,13 @@ $primary-color:  #3364dd;
 $font-color: black;
 $background-color: desaturate(#fcfaf3, 80%);
 
+@import url('https://fonts.googleapis.com/css?family=Roboto');
+@import url('https://fonts.googleapis.com/css?family=Ubuntu+Mono');
+
 body {
   margin: 0 auto;
   max-width: 50em;
-  font-family: 'Helvetica', serif;
+  font-family: -apple-system, 'Roboto',  serif;
   background-color: $background-color;
 
   line-height: 1.5;
@@ -16,6 +19,7 @@ body {
 code {
     color: $primary-color;
     background-color: white;
+    font-family: "Ubuntu Mono";
 }
 
 // Override bootstrap.
@@ -36,12 +40,4 @@ a.button {
     text-decoration: none;
     color: initial;
     padding: 3px;
-}
-
-// Hugo Table of Contents
-nav ul {
-  padding-inline-start: 0px;
-}
-nav li {
-  padding-inline-start: 15px;
 }

site/themes/sail/layouts/doc/single.html

@@ -49,7 +49,7 @@ <h1>Sail Documentation</h1>
                 </ul>
             </dl>
         </div>
-        <div class="col-lg">
+        <div class="col-lg content-box">
             <h1> {{ .Title }} </h1>
             {{ .Content }}
         </div>