Updated documentation

Author: coordt

docsrc/actions/metadata.md

@@ -5,3 +5,33 @@
 ### Arguments
 
 commit_metadata
+
+In Git, trailers are key-value pairs written inside of commit messages that, make things like issue references programmatically accessible. For example, the following commit message:
+
+```
+Awesome new feature
+
+Some details about this commit
+
+Closes: #1234
+```
+
+The last line is an example for a trailer. It consists of a token (`Closes`), a separator (`:`), and a value (`#1234`).
+
+
+
+This action will convert the above commit message to:
+
+```
+Awesome new feature
+
+Some details about this commit
+```
+
+And add set `metadata.trailers.Closes` to `#1234` for easy reference in the template.
+
+More info
+
+https://git.wiki.kernel.org/index.php/CommitMessageConventions
+
+https://lore.kernel.org/git/60ad75ac7ffca_2ae08208b@natae.notmuch/

docsrc/api.rst

@@ -9,10 +9,12 @@ API Reference
    :recursive:
 
    ~actions
+   ~cli
    ~configuration
+   ~context
    ~data_merge
    ~git_ops
-   ~lazy
    ~pipeline
    ~templating
    ~utilities
+   ~_attr_docs

docsrc/commit-organization.svg

@@ -69,6 +69,7 @@
     "tasklist",
     "fieldlist",
 ]
+myst_heading_anchors = 2
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),
     "gitpython": ("https://gitpython.readthedocs.io/en/stable/", None),