docs: improve state docs

gitea/mods/rst/clean.sls

@@ -1,6 +1,11 @@
 # -*- coding: utf-8 -*-
 # vim: ft=sls
 
+{#-
+    Removes the built ``chroma`` binary, the build path and the
+    ``grst`` script.
+#}
+
 {%- set tplroot = tpldir.split('/')[0] %}
 {%- set sls_config_file = tplroot ~ '.config.file' %}
 {%- from tplroot ~ "/map.jinja" import mapdata as gitea with context %}

gitea/mods/rst/init.sls

@@ -1,6 +1,14 @@
 # -*- coding: utf-8 -*-
 # vim: ft=sls
 
+{#-
+    Compiles `Chroma <https://github.com/alecthomas/chroma>`_ from source
+    and installs a Python script that can be setup as an external renderer
+    for ``*.rst`` files.
+
+    Has a dependency on `gitea.go`_.
+#}
+
 {%- set tplroot = tpldir.split('/')[0] %}
 {%- set sls_config_file = tplroot ~ '.config.file' %}
 {%- set sls_go_install = tplroot ~ '.go' %}