From 207dea91dac71e6fb73d8c971001d462be791954 Mon Sep 17 00:00:00 2001
From: Pat Cavit <github@patcavit.com>
Date: Tue, 28 Mar 2017 11:37:07 -0700
Subject: [PATCH] docs: merge 7ba74ad and friends

---
 docs/components.md                  |  6 ++--
 docs/generate.js                    | 14 ++++----
 docs/index.md                       |  4 +--
 docs/layout.html                    |  6 ++--
 docs/lib/prism/prism.css            |  6 ----
 docs/lib/prism/prism.js             |  7 ----
 docs/{guides.md => nav-guides.md}   |  0
 docs/{methods.md => nav-methods.md} |  0
 docs/releasing.md                   | 55 ++++++++++++++++++-----------
 docs/style.css                      | 33 ++++++++++++-----
 10 files changed, 72 insertions(+), 59 deletions(-)
 delete mode 100644 docs/lib/prism/prism.css
 delete mode 100644 docs/lib/prism/prism.js
 rename docs/{guides.md => nav-guides.md} (100%)
 rename docs/{methods.md => nav-methods.md} (100%)

diff --git a/docs/components.md b/docs/components.md
index 3d958aad..229f1293 100644
--- a/docs/components.md
+++ b/docs/components.md
@@ -2,9 +2,9 @@
 
 - [Structure](#structure)
 - [Lifecycle methods](#lifecycle-methods)
+- [Syntactic variants](#syntactic-variants)
 - [State](#state)
-- [ES6 classes](#es6-classes)
-- [Avoid-anti-patterns](#avoid-anti-patterns)
+- [Avoid anti-patterns](#avoid-anti-patterns)
 
 ### Structure
 
@@ -101,7 +101,7 @@ To learn more about lifecycle methods, [see the lifecycle methods page](lifecycl
 
 ---
 
-### Alternate component syntaxes
+### Syntactic variants
 
 #### ES6 classes
 
diff --git a/docs/generate.js b/docs/generate.js
index 438b8343..52bc3e70 100644
--- a/docs/generate.js
+++ b/docs/generate.js
@@ -8,13 +8,9 @@ var version = JSON.parse(fs.readFileSync("./package.json", "utf-8")).version
 try {fs.mkdirSync("./dist")} catch (e) {/* ignore */}
 try {fs.mkdirSync("./dist/archive")} catch (e) {/* ignore */}
 try {fs.mkdirSync("./dist/archive/v" + version)} catch (e) {/* ignore */}
-try {fs.mkdirSync("./dist/archive/v" + version + "/lib")} catch (e) {/* ignore */}
-try {fs.mkdirSync("./dist/archive/v" + version + "/lib/prism")} catch (e) {/* ignore */}
-try {fs.mkdirSync("./dist/lib")} catch (e) {/* ignore */}
-try {fs.mkdirSync("./dist/lib/prism")} catch (e) {/* ignore */}
 
-var guides = fs.readFileSync("docs/guides.md", "utf-8")
-var methods = fs.readFileSync("docs/methods.md", "utf-8")
+var guides = fs.readFileSync("docs/nav-guides.md", "utf-8")
+var methods = fs.readFileSync("docs/nav-methods.md", "utf-8")
 
 var index = fs.readFileSync("docs/index.md", "utf-8")
 fs.writeFileSync("README.md", index.replace(/(\]\()(.+?)\.md(\))/g, "$1http://mithril.js.org/$2.html$3"), "utf-8")
@@ -27,7 +23,7 @@ function generate(pathname) {
 			generate(pathname + "/" + filename)
 		})
 	}
-	else if (!pathname.match(/tutorials|archive|guides|methods/)) {
+	else if (!pathname.match(/tutorials|archive|nav-/)) {
 		if (pathname.match(/\.md$/)) {
 			var outputFilename = pathname.replace(/\.md$/, ".html")
 			var markdown = fs.readFileSync(pathname, "utf-8")
@@ -55,7 +51,9 @@ function generate(pathname) {
 				.replace(/\[version\]/, version) // update version
 				.replace(/\[body\]/, markedHtml)
 				.replace(/<h(.) id="([^"]+?)">(.+?)<\/h.>/gim, function(match, n, id, text) { // fix anchors
-					return "<h" + n + ' id="' + text.toLowerCase().replace(/<(\/?)code>/g, "").replace(/<a.*?>.+?<\/a>/g, "").replace(/\.|\[|\]|&quot;|\/|\(|\)/g, "").replace(/\s/g, "-") + '">' + text + "</h" + n + ">"
+					var anchor = text.toLowerCase().replace(/<(\/?)code>/g, "").replace(/<a.*?>.+?<\/a>/g, "").replace(/\.|\[|\]|&quot;|\/|\(|\)/g, "").replace(/\s/g, "-");
+
+					return `<h${n} id="${anchor}"><a href="#${anchor}">${text}</a></h${n}>`;
 				})
 			fs.writeFileSync("./dist/archive/v" + version + "/" + outputFilename.replace(/^docs\//, ""), html, "utf-8")
 			fs.writeFileSync("./dist/" + outputFilename.replace(/^docs\//, ""), html, "utf-8")
diff --git a/docs/index.md b/docs/index.md
index 1481b21e..86aca2cc 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -12,7 +12,7 @@
 
 ### What is Mithril?
 
-Mithril is a modern client-side Javascript framework for building Single Page Applications.  
+Mithril is a modern client-side Javascript framework for building Single Page Applications.
 It's small (< 8kb gzip), fast and provides routing and XHR utilities out of the box.
 
 <div style="display:flex;margin:0 0 30px;">
@@ -69,7 +69,7 @@ Let's create an HTML file to follow along:
 
 ### Hello world
 
-Let's start as small as well can: render some text on screen. Copy the code below into your file (and by copy, I mean type it out - you'll learn better)
+Let's start as small as we can: render some text on screen. Copy the code below into your file (and by copy, I mean type it out - you'll learn better)
 
 ```javascript
 var root = document.body
diff --git a/docs/layout.html b/docs/layout.html
index 9dac0d2d..f5ce0231 100644
--- a/docs/layout.html
+++ b/docs/layout.html
@@ -2,8 +2,7 @@
 	<head>
 		<meta charset="UTF-8" />
 		<title>Mithril.js</title>
-		<link href='https://fonts.googleapis.com/css?family=Open+Sans' rel='stylesheet' type='text/css' />
-		<link href="lib/prism/prism.css" rel="stylesheet" />
+		<link href="https://fonts.googleapis.com/css?family=Open+Sans" rel="stylesheet" />
 		<link href="style.css" rel="stylesheet" />
 		<meta name="viewport" content="width=device-width, initial-scale=1" />
 	</head>
@@ -27,7 +26,8 @@
 				<small>License: MIT. &copy; Leo Horie.</small>
 			</section>
 		</main>
-		<script src="lib/prism/prism.js"></script>
+		<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.6.0/prism.min.js"></script>
+		<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.6.0/components/prism-jsx.min.js"></script>
 		<script>
 		document.querySelector(".hamburger").onclick = function() {
 			document.body.className = document.body.className === "navigating" ? "" : "navigating"
diff --git a/docs/lib/prism/prism.css b/docs/lib/prism/prism.css
deleted file mode 100644
index 0c252867..00000000
--- a/docs/lib/prism/prism.css
+++ /dev/null
@@ -1,6 +0,0 @@
-.token.comment,.token.prolog,.token.doctype,.token.cdata {color:#888;}
-.token.property,.token.tag,.token.boolean,.token.number,.token.constant,.token.symbol {color:#905;}
-.token.selector,.token.attr-name,.token.string,.token.builtin {color:#690;}
-.token.atrule,.token.attr-value,.token.punctuation,.token.keyword {color:#1e5799;}
-.token.regex,.token.important {color:#e90;}
-
diff --git a/docs/lib/prism/prism.js b/docs/lib/prism/prism.js
deleted file mode 100644
index 8a986b63..00000000
--- a/docs/lib/prism/prism.js
+++ /dev/null
@@ -1,7 +0,0 @@
-/* http://prismjs.com/download.html?themes=prism&languages=markup+css+clike+javascript+jsx */
-var _self="undefined"!=typeof window?window:"undefined"!=typeof WorkerGlobalScope&&self instanceof WorkerGlobalScope?self:{},Prism=function(){var e=/\blang(?:uage)?-(\w+)\b/i,t=0,n=_self.Prism={util:{encode:function(e){return e instanceof a?new a(e.type,n.util.encode(e.content),e.alias):"Array"===n.util.type(e)?e.map(n.util.encode):e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/\u00a0/g," ")},type:function(e){return Object.prototype.toString.call(e).match(/\[object (\w+)\]/)[1]},objId:function(e){return e.__id||Object.defineProperty(e,"__id",{value:++t}),e.__id},clone:function(e){var t=n.util.type(e);switch(t){case"Object":var a={};for(var r in e)e.hasOwnProperty(r)&&(a[r]=n.util.clone(e[r]));return a;case"Array":return e.map&&e.map(function(e){return n.util.clone(e)})}return e}},languages:{extend:function(e,t){var a=n.util.clone(n.languages[e]);for(var r in t)a[r]=t[r];return a},insertBefore:function(e,t,a,r){r=r||n.languages;var i=r[e];if(2==arguments.length){a=arguments[1];for(var l in a)a.hasOwnProperty(l)&&(i[l]=a[l]);return i}var o={};for(var s in i)if(i.hasOwnProperty(s)){if(s==t)for(var l in a)a.hasOwnProperty(l)&&(o[l]=a[l]);o[s]=i[s]}return n.languages.DFS(n.languages,function(t,n){n===r[e]&&t!=e&&(this[t]=o)}),r[e]=o},DFS:function(e,t,a,r){r=r||{};for(var i in e)e.hasOwnProperty(i)&&(t.call(e,i,e[i],a||i),"Object"!==n.util.type(e[i])||r[n.util.objId(e[i])]?"Array"!==n.util.type(e[i])||r[n.util.objId(e[i])]||(r[n.util.objId(e[i])]=!0,n.languages.DFS(e[i],t,i,r)):(r[n.util.objId(e[i])]=!0,n.languages.DFS(e[i],t,null,r)))}},plugins:{},highlightAll:function(e,t){var a={callback:t,selector:'code[class*="language-"], [class*="language-"] code, code[class*="lang-"], [class*="lang-"] code'};n.hooks.run("before-highlightall",a);for(var r,i=a.elements||document.querySelectorAll(a.selector),l=0;r=i[l++];)n.highlightElement(r,e===!0,a.callback)},highlightElement:function(t,a,r){for(var i,l,o=t;o&&!e.test(o.className);)o=o.parentNode;o&&(i=(o.className.match(e)||[,""])[1].toLowerCase(),l=n.languages[i]),t.className=t.className.replace(e,"").replace(/\s+/g," ")+" language-"+i,o=t.parentNode,/pre/i.test(o.nodeName)&&(o.className=o.className.replace(e,"").replace(/\s+/g," ")+" language-"+i);var s=t.textContent,u={element:t,language:i,grammar:l,code:s};if(n.hooks.run("before-sanity-check",u),!u.code||!u.grammar)return u.code&&(u.element.textContent=u.code),n.hooks.run("complete",u),void 0;if(n.hooks.run("before-highlight",u),a&&_self.Worker){var g=new Worker(n.filename);g.onmessage=function(e){u.highlightedCode=e.data,n.hooks.run("before-insert",u),u.element.innerHTML=u.highlightedCode,r&&r.call(u.element),n.hooks.run("after-highlight",u),n.hooks.run("complete",u)},g.postMessage(JSON.stringify({language:u.language,code:u.code,immediateClose:!0}))}else u.highlightedCode=n.highlight(u.code,u.grammar,u.language),n.hooks.run("before-insert",u),u.element.innerHTML=u.highlightedCode,r&&r.call(t),n.hooks.run("after-highlight",u),n.hooks.run("complete",u)},highlight:function(e,t,r){var i=n.tokenize(e,t);return a.stringify(n.util.encode(i),r)},tokenize:function(e,t){var a=n.Token,r=[e],i=t.rest;if(i){for(var l in i)t[l]=i[l];delete t.rest}e:for(var l in t)if(t.hasOwnProperty(l)&&t[l]){var o=t[l];o="Array"===n.util.type(o)?o:[o];for(var s=0;s<o.length;++s){var u=o[s],g=u.inside,c=!!u.lookbehind,h=!!u.greedy,f=0,d=u.alias;if(h&&!u.pattern.global){var p=u.pattern.toString().match(/[imuy]*$/)[0];u.pattern=RegExp(u.pattern.source,p+"g")}u=u.pattern||u;for(var m=0,y=0;m<r.length;y+=r[m].length,++m){var v=r[m];if(r.length>e.length)break e;if(!(v instanceof a)){u.lastIndex=0;var b=u.exec(v),k=1;if(!b&&h&&m!=r.length-1){if(u.lastIndex=y,b=u.exec(e),!b)break;for(var w=b.index+(c?b[1].length:0),_=b.index+b[0].length,A=m,P=y,j=r.length;j>A&&_>P;++A)P+=r[A].length,w>=P&&(++m,y=P);if(r[m]instanceof a||r[A-1].greedy)continue;k=A-m,v=e.slice(y,P),b.index-=y}if(b){c&&(f=b[1].length);var w=b.index+f,b=b[0].slice(f),_=w+b.length,x=v.slice(0,w),O=v.slice(_),S=[m,k];x&&S.push(x);var N=new a(l,g?n.tokenize(b,g):b,d,b,h);S.push(N),O&&S.push(O),Array.prototype.splice.apply(r,S)}}}}}return r},hooks:{all:{},add:function(e,t){var a=n.hooks.all;a[e]=a[e]||[],a[e].push(t)},run:function(e,t){var a=n.hooks.all[e];if(a&&a.length)for(var r,i=0;r=a[i++];)r(t)}}},a=n.Token=function(e,t,n,a,r){this.type=e,this.content=t,this.alias=n,this.length=0|(a||"").length,this.greedy=!!r};if(a.stringify=function(e,t,r){if("string"==typeof e)return e;if("Array"===n.util.type(e))return e.map(function(n){return a.stringify(n,t,e)}).join("");var i={type:e.type,content:a.stringify(e.content,t,r),tag:"span",classes:["token",e.type],attributes:{},language:t,parent:r};if("comment"==i.type&&(i.attributes.spellcheck="true"),e.alias){var l="Array"===n.util.type(e.alias)?e.alias:[e.alias];Array.prototype.push.apply(i.classes,l)}n.hooks.run("wrap",i);var o=Object.keys(i.attributes).map(function(e){return e+'="'+(i.attributes[e]||"").replace(/"/g,"&quot;")+'"'}).join(" ");return"<"+i.tag+' class="'+i.classes.join(" ")+'"'+(o?" "+o:"")+">"+i.content+"</"+i.tag+">"},!_self.document)return _self.addEventListener?(_self.addEventListener("message",function(e){var t=JSON.parse(e.data),a=t.language,r=t.code,i=t.immediateClose;_self.postMessage(n.highlight(r,n.languages[a],a)),i&&_self.close()},!1),_self.Prism):_self.Prism;var r=document.currentScript||[].slice.call(document.getElementsByTagName("script")).pop();return r&&(n.filename=r.src,document.addEventListener&&!r.hasAttribute("data-manual")&&("loading"!==document.readyState?window.requestAnimationFrame?window.requestAnimationFrame(n.highlightAll):window.setTimeout(n.highlightAll,16):document.addEventListener("DOMContentLoaded",n.highlightAll))),_self.Prism}();"undefined"!=typeof module&&module.exports&&(module.exports=Prism),"undefined"!=typeof global&&(global.Prism=Prism);
-Prism.languages.markup={comment:/<!--[\w\W]*?-->/,prolog:/<\?[\w\W]+?\?>/,doctype:/<!DOCTYPE[\w\W]+?>/i,cdata:/<!\[CDATA\[[\w\W]*?]]>/i,tag:{pattern:/<\/?(?!\d)[^\s>\/=$<]+(?:\s+[^\s>\/=]+(?:=(?:("|')(?:\\\1|\\?(?!\1)[\w\W])*\1|[^\s'">=]+))?)*\s*\/?>/i,inside:{tag:{pattern:/^<\/?[^\s>\/]+/i,inside:{punctuation:/^<\/?/,namespace:/^[^\s>\/:]+:/}},"attr-value":{pattern:/=(?:('|")[\w\W]*?(\1)|[^\s>]+)/i,inside:{punctuation:/[=>"']/}},punctuation:/\/?>/,"attr-name":{pattern:/[^\s>\/]+/,inside:{namespace:/^[^\s>\/:]+:/}}}},entity:/&#?[\da-z]{1,8};/i},Prism.hooks.add("wrap",function(a){"entity"===a.type&&(a.attributes.title=a.content.replace(/&amp;/,"&"))}),Prism.languages.xml=Prism.languages.markup,Prism.languages.html=Prism.languages.markup,Prism.languages.mathml=Prism.languages.markup,Prism.languages.svg=Prism.languages.markup;
-Prism.languages.css={comment:/\/\*[\w\W]*?\*\//,atrule:{pattern:/@[\w-]+?.*?(;|(?=\s*\{))/i,inside:{rule:/@[\w-]+/}},url:/url\((?:(["'])(\\(?:\r\n|[\w\W])|(?!\1)[^\\\r\n])*\1|.*?)\)/i,selector:/[^\{\}\s][^\{\};]*?(?=\s*\{)/,string:{pattern:/("|')(\\(?:\r\n|[\w\W])|(?!\1)[^\\\r\n])*\1/,greedy:!0},property:/(\b|\B)[\w-]+(?=\s*:)/i,important:/\B!important\b/i,"function":/[-a-z0-9]+(?=\()/i,punctuation:/[(){};:]/},Prism.languages.css.atrule.inside.rest=Prism.util.clone(Prism.languages.css),Prism.languages.markup&&(Prism.languages.insertBefore("markup","tag",{style:{pattern:/(<style[\w\W]*?>)[\w\W]*?(?=<\/style>)/i,lookbehind:!0,inside:Prism.languages.css,alias:"language-css"}}),Prism.languages.insertBefore("inside","attr-value",{"style-attr":{pattern:/\s*style=("|').*?\1/i,inside:{"attr-name":{pattern:/^\s*style/i,inside:Prism.languages.markup.tag.inside},punctuation:/^\s*=\s*['"]|['"]\s*$/,"attr-value":{pattern:/.+/i,inside:Prism.languages.css}},alias:"language-css"}},Prism.languages.markup.tag));
-Prism.languages.clike={comment:[{pattern:/(^|[^\\])\/\*[\w\W]*?\*\//,lookbehind:!0},{pattern:/(^|[^\\:])\/\/.*/,lookbehind:!0}],string:{pattern:/(["'])(\\(?:\r\n|[\s\S])|(?!\1)[^\\\r\n])*\1/,greedy:!0},"class-name":{pattern:/((?:\b(?:class|interface|extends|implements|trait|instanceof|new)\s+)|(?:catch\s+\())[a-z0-9_\.\\]+/i,lookbehind:!0,inside:{punctuation:/(\.|\\)/}},keyword:/\b(if|else|while|do|for|return|in|instanceof|function|new|try|throw|catch|finally|null|break|continue)\b/,"boolean":/\b(true|false)\b/,"function":/[a-z0-9_]+(?=\()/i,number:/\b-?(?:0x[\da-f]+|\d*\.?\d+(?:e[+-]?\d+)?)\b/i,operator:/--?|\+\+?|!=?=?|<=?|>=?|==?=?|&&?|\|\|?|\?|\*|\/|~|\^|%/,punctuation:/[{}[\];(),.:]/};
-Prism.languages.javascript=Prism.languages.extend("clike",{keyword:/\b(as|async|await|break|case|catch|class|const|continue|debugger|default|delete|do|else|enum|export|extends|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|new|null|of|package|private|protected|public|return|set|static|super|switch|this|throw|try|typeof|var|void|while|with|yield)\b/,number:/\b-?(0x[\dA-Fa-f]+|0b[01]+|0o[0-7]+|\d*\.?\d+([Ee][+-]?\d+)?|NaN|Infinity)\b/,"function":/[_$a-zA-Z\xA0-\uFFFF][_$a-zA-Z0-9\xA0-\uFFFF]*(?=\()/i,operator:/--?|\+\+?|!=?=?|<=?|>=?|==?=?|&&?|\|\|?|\?|\*\*?|\/|~|\^|%|\.{3}/}),Prism.languages.insertBefore("javascript","keyword",{regex:{pattern:/(^|[^\/])\/(?!\/)(\[.+?]|\\.|[^\/\\\r\n])+\/[gimyu]{0,5}(?=\s*($|[\r\n,.;})]))/,lookbehind:!0,greedy:!0}}),Prism.languages.insertBefore("javascript","string",{"template-string":{pattern:/`(?:\\\\|\\?[^\\])*?`/,greedy:!0,inside:{interpolation:{pattern:/\$\{[^}]+\}/,inside:{"interpolation-punctuation":{pattern:/^\$\{|\}$/,alias:"punctuation"},rest:Prism.languages.javascript}},string:/[\s\S]+/}}}),Prism.languages.markup&&Prism.languages.insertBefore("markup","tag",{script:{pattern:/(<script[\w\W]*?>)[\w\W]*?(?=<\/script>)/i,lookbehind:!0,inside:Prism.languages.javascript,alias:"language-javascript"}}),Prism.languages.js=Prism.languages.javascript;
-!function(a){var e=a.util.clone(a.languages.javascript);a.languages.jsx=a.languages.extend("markup",e),a.languages.jsx.tag.pattern=/<\/?[\w\.:-]+\s*(?:\s+[\w\.:-]+(?:=(?:("|')(\\?[\w\W])*?\1|[^\s'">=]+|(\{[\w\W]*?\})))?\s*)*\/?>/i,a.languages.jsx.tag.inside["attr-value"].pattern=/=[^\{](?:('|")[\w\W]*?(\1)|[^\s>]+)/i;var s=a.util.clone(a.languages.jsx);delete s.punctuation,s=a.languages.insertBefore("jsx","operator",{punctuation:/=(?={)|[{}[\];(),.:]/},{jsx:s}),a.languages.insertBefore("inside","attr-value",{script:{pattern:/=(\{(?:\{[^}]*\}|[^}])+\})/i,inside:s,alias:"language-javascript"}},a.languages.jsx.tag)}(Prism);
diff --git a/docs/guides.md b/docs/nav-guides.md
similarity index 100%
rename from docs/guides.md
rename to docs/nav-guides.md
diff --git a/docs/methods.md b/docs/nav-methods.md
similarity index 100%
rename from docs/methods.md
rename to docs/nav-methods.md
diff --git a/docs/releasing.md b/docs/releasing.md
index eadab31b..12ceb19b 100644
--- a/docs/releasing.md
+++ b/docs/releasing.md
@@ -1,36 +1,49 @@
 # Releasing
 
-Releasing new builds of mithril is mostly automated via `npm version`
-
 ## Publishing to NPM
 
-1. `npm run release <major|minor|patch|semver>`
+Releasing new builds of mithril to NPM is mostly automated via `npm run release`
+
+1. Update information in `docs/change-log.md` to match reality & the new version that will be released
+2. `npm run release <major|minor|patch|semver>`
 
 All further steps are automated and run as follows:
 
-2. New bundles are generated using updated version
-3. Tests are run
-4. Linting is run (but doesn't fail build)
-5. Version number in package.json is incremented
-6. `git add` called on bundle output
-7. `package.json` and updated bundles are committed to git
-8. previous commit is tagged using new version number
-9. `git push --follow-tags` pushes up new version commit & tag to github
-10. Travis sees new release, starts build
-11. Travis generates new bundles before running tests
-12. Travis runs tests
-13. Travis lints files (but can't fail build)
-14. If build fails, abort
-15. Build succeeded, so travis will commit back any changes to the repo (but there won't be any)
-16. Travis sees that this commit has a tag associated with it
-17. Travis will use the encrypted npm creds in `.travis.yml` to publish a new version to npm
+3. New bundles are generated using updated version
+4. Tests are run
+5. Linting is run (but doesn't fail build)
+6. Version number in package.json is incremented
+7. `git add` called on bundle output
+8. `package.json` and updated bundles are committed to git
+9. previous commit is tagged using new version number
+10. `git push --follow-tags` pushes up new version commit & tag to github
+11. Travis sees new release, starts build
+12. Travis generates new bundles before running tests
+13. Travis runs tests
+14. Travis lints files (but can't fail build)
+15. If build fails, abort
+16. Build succeeded, so travis will commit back any changes to the repo (but there won't be any)
+17. Travis sees that this commit has a tag associated with it
+18. Travis will use the encrypted npm creds in `.travis.yml` to publish a new version to npm
 
 ## Publishing a GitHub release
 
 Happens automatically as part of the [Publishing to NPM](#publishing-to-npm) process described above.
 
-Does require a manual description to be added though, as the auto-generated one isn't very interesting.
+Does require a manual description to be added though, as the auto-generated one isn't very interesting. I suggest coming up with a fun title & then copying the `docs/change-log.md` entry for the build.
 
 ## Updating `docs/change-log.md`
 
-**TODO**
+This is still a manual process, I'm sorry.
+
+## Updating docs (outside of a new version)
+
+Fixes to documentation can land whenever, updates to the site are published via Travis.
+
+1. `git co next`
+2. `git pull lhorie next`
+3. `git co master`
+4. `git co next -- ./docs`
+5. Ensure that no new features are added
+6. `git push lhorie`
+7. After the Travis build completes new docs should appear in ~3 minutes
diff --git a/docs/style.css b/docs/style.css
index afd99f62..cb2f1e10 100644
--- a/docs/style.css
+++ b/docs/style.css
@@ -6,17 +6,10 @@ nav a {border-left:1px solid #ddd;padding:0 10px;}
 nav a:first-child {border:0;padding-left:0;}
 main {margin-bottom:100px;}
 main section {margin-left:270px;}
-h1 {font-size:24px;margin:0 0 15px;}
-h2 {font-size:22px;margin:45px 0 15px;}
-h3 {font-size:20px;margin:45px 0 15px;}
-h4 {font-size:18px;margin:30px 0 15px;}
-h5 {font-weight:bold;margin:15px 0 15px;}
-h1 img {transform:rotate(180deg);vertical-align:middle;width:20px;}
-h1 small {font-size:16px;}
 p {margin:0 0 15px;}
 pre,code {background:#eee;font-family:monospace;font-size:14px;}
-pre {border-left:3px solid #1e5799;overflow:auto;padding:10px 20px;}
-code {border:1px solid #ddd;display:inline-block;margin:0 0 1px;padding:3px;white-space:pre;}
+pre {border-left:3px solid #1e5799;overflow:auto;padding:10px 20px;margin:20px 0;}
+code {border:1px solid #ddd;display:inline-block;margin:0 0 1px;padding:5px 3px;white-space:pre;}
 pre code {border:0;margin:0;padding:0;}
 table {border-collapse:collapse;margin:0 0 30px;width:100%;}
 tbody tr:nth-child(odd) {background:#fafafa;}
@@ -28,6 +21,21 @@ a {color:#1e5799;text-decoration:none;}
 a:hover {text-decoration:underline;}
 hr {border:0;border-bottom:1px solid #ddd;margin:30px 0;}
 
+/* Headings */
+h1,h2,h3,h4,h5 {position:relative}
+h1 {font-size:24px;margin:0 0 15px;}
+h2 {font-size:22px;margin:45px 0 15px;}
+h3 {font-size:20px;margin:45px 0 15px;}
+h4 {font-size:18px;margin:30px 0 15px;}
+h5 {font-weight:bold;margin:15px 0 15px;}
+h1 img {transform:rotate(180deg);vertical-align:middle;width:20px;}
+h1 small {font-size:16px;}
+h2 a,h3 a,h4 a,h5 a,
+h2 a:hover,h3 a:hover,h4 a:hover,h5 a:hover,
+h2 a:active,h3 a:active,h4 a:active,h5 a:active,
+h2 a:visited,h3 a:visited,h4 a:visited,h5 a:visited {color:#000;text-decoration:none;}
+h2::before,h3::before,h4::before,h5::before {content:"#";position:absolute;left:-20px;visibility:hidden;}
+h2:hover::before,h3:hover::before,h4:hover::before,h5:hover::before {visibility:visible;}
 #signature + p code {padding:3px 10px;}
 h1 + ul {margin:40px 0 0 -270px;padding:0;position:absolute;width:250px;}
 h1 + ul + hr {display:none;}
@@ -80,3 +88,10 @@ h1 + ul strong + ul {border-left:3px solid #1e5799;}
 	nav,h1 + ul {display:none;}
 	main section {margin:0;}
 }
+
+/* prism theming */
+.token.comment,.token.prolog,.token.doctype,.token.cdata {color:#888;}
+.token.property,.token.tag,.token.boolean,.token.number,.token.constant,.token.symbol {color:#905;}
+.token.selector,.token.attr-name,.token.string,.token.builtin {color:#690;}
+.token.atrule,.token.attr-value,.token.punctuation,.token.keyword {color:#1e5799;}
+.token.regex,.token.important {color:#e90;}