More docs

Author: davegaeddert

bolt/bolt/signals/README.md

@@ -1,3 +1,14 @@
-# signals
+# Signals
 
 Run code when certain events happen.
+
+```python
+from bolt.signals import request_finished
+
+
+def on_request_finished(sender, **kwargs):
+    print("Request finished!")
+
+
+request_finished.connect(on_request_finished)
+```

bolt/bolt/templates/README.md

@@ -0,0 +1,20 @@
+# Templates
+
+Render HTML templates using Jinja.
+
+Templates are typically rendered in `TemplateViews`,
+but you can also render them directly to strings for emails or other use cases.
+
+```python
+from bolt.templates import Template
+
+
+Template("comment.md").render({
+    "message": "Hello, world!",
+})
+```
+
+Template files can be located in either a root `app/templates`,
+or the `templates` directory in any installed packages.
+
+[Customizing Jinja](./jinja/README.md)

bolt/bolt/templates/jinja/README.md

@@ -1,6 +1,4 @@
-# Templates
-
-Render templates using Jinja2.
+# Jinja
 
 Templates can be stored inside `INSTALLED_PACKAGES` (ex. `app/<pkg>/templates`) or in the `templates` directory at the root of your project (ex. `app/templates`).
 
@@ -11,6 +9,9 @@ which the whole app depends on.
 
 ### Package templates
 
+Since all template directories are effectively "merged" together,
+packages will typically namespace their own templates such as `app/users/templates/users/delete.html`.
+
 ## Jinja
 
 There is a default set of globals, filters, and extensions.