[feature] documentation additions

README.md

@@ -93,6 +93,39 @@ fogg completion bash > $(brew --prefix)/etc/bash_completion.d/fogg
 
 You can add the file generated by `fogg completion zsh` to a directory in your $fpath.
 
+### Typical Fogg actions
+All of these snippets would belong in your project's `fogg.yml` file.
+#### Add a new component
+``` yaml
+section_name:
+    components:
+        <component name here>
+            <add subsections yaml-style>
+```
+
+#### Adding and using a new module
+``` yaml
+modules:
+    <module name>: {}
+```
+
+#### Referencing modules from other repositories
+Make sure you have `module_source` defined
+
+Format:
+
+`module_source: github.com/<repository slug>//<module name>?ref=<release value>`
+
+#### Using remote state
+You will need to set some default backend details. Here's an example:
+``` yaml
+defaults:
+    backend:
+        bucket: <AWS Bucket name>
+        profile: <AWS Profile name>
+        region: <AWS Region>
+```
+
 ## Design Principles
 
 ### Convention over Configuration