Finish up docs

Author: srid

docs/guide/html-template.md

@@ -1,8 +1,14 @@
 # HTML Templates
 
-The HTML used by Emanote is under the full control of the user by way of the [[layer]].
+Unlike [[neuron|Neuron]], Emanote's generated HTML can be **completely** customized. Emanote uses the Heist HTML template system that supports non-trivial constructs like recursion; see [here](http://snapframework.com/docs/tutorials/heist) for a tutorial on its syntax. 
 
-[ ] Write this.
+The default HTML templates are stored in the [[layer|default layer]], which can you override either totally or in subset. 
+
+## Layouts
+
+Emanote includes two builtin layouts, called `book` (the default) and [[neuron-layout|`note`]], but you can also write your own HTML layout from scratch, as long as you specify that template in [[yaml-config]] for the notes in question. For eg., [`templates/home.tpl`](https://github.com/srid/srid/blob/master/content/templates/home.tpl) is how https://srid.ca homepage is generated, because its [`index.md`](https://raw.githubusercontent.com/srid/srid/master/content/index.md) specifies this template as `template.name` in its YAML frontmatter (which could also be `index.yaml`).
+
+## Features
 
 ```query
 path:./*

docs/guide/html-template/sidebar.md

@@ -6,5 +6,3 @@ In [[html-template|the `book` template]], the sidebar is rendered on the left si
 - The ordering of children in the tree is determined in the following order (this is also the order in which [[query]] results are rendered by default):
   1. If the `order` [[yaml-config|frontmatter]] metadata exists, use that as the primary sort key.
   2. If the note has a H1 title, use that as the secondary sort key; otherwise, use the note filename as the secondary sort key.
-
-- [ ] The same layout is used in the note index page. Create index/{note,tag,task} doc tree. 

docs/guide/layer.md

@@ -1,5 +1,11 @@
 # Layer system
 
-[ ] Write this
-  - Default layer (provides [[html-template]], fonts, logo, [[markdown|index.md]], etc.)
-  - How users can override the files in the default layer
+Emanote's layer system allows you to "merge" multiple notebooks and treat them as if they were a single notebook. The `-L` option in the command line accepts layers, and you can specify multiple of them with the right most taking the most precedence.
+
+## "Default" layer
+
+Emanote *implicitly* includes what is known as the "default" layer. Its contents can be seen [here](https://github.com/EmaApps/emanote/tree/master/default). This layer contains [[html-template]], [[yaml-config|index.yaml]] and other default assets, like the logo, favicon and fonts. When you run `emanote -L /your/notebook run`, your notebook is overlaid *on top of* this default layer. What this means, in effect, is that you override **just about any file** in the default layer, such the HTML content of [[html-template]], in your own notebook directory. As an example, see [`template/hooks`](https://github.com/EmaApps/emanote/tree/master/docs/templates/hooks) of this documentation notbook.
+
+## Merge semantics
+
+The default merge semantic is to replace with the file on the right layer. For some file types, special merge semantic applies. For example, [[yaml-config|YAML files]] are merged by deep merge, not file-level replacement. This is what allows you to create `index.yaml` that overrides only a subset of the default configuration.

docs/index.md

@@ -11,9 +11,7 @@ page:
 :::
 
 :::{.text-gray-600}
-[Emanote][gh] is currently in **beta** phase. Feel free to try it out and give feedback, to ensure that the upcoming 1.0 release is solid. See [[examples|websites using Emanote]].
-
-Begin from [[start]], and then read through [[guide]].
+Begin from [[start]], and then read through [[guide]]. See [[examples|websites using Emanote]].
 
 Emanote is written in [Haskell](https://srid.ca/haskell). If you are interested in contributing, see [[architecture]].
 :::