service/status.md

@@ -32,16 +32,31 @@ The content can also be built in the `public/` directory with, simply:
 
     hugo
 
-## Modifying the site
+## Creating new issues
 
-Issues are in `content/issues/`. You can copy an existing issue and use
-it as a template. The [upstream guide on how to create issues](https://github.com/cstate/cstate/wiki/Usage#creating-incidents-method-1) is
-fairly thorough and should be followed.
+Issues are stored in `content/issues/`. You can create a new issue
+with `hugo new`, for example:
+
+    hugo new issues/2021-02-03-testing-cstate-again.md
+
+This will open an editor with a pre-filled template, called an
+[archetype in Hugo](https://gohugo.io/content-management/archetypes/). 
+
+If you do not have hugo installed locally, you can also copy the
+template directly (from `themes/cstate/archetypes/default.md`), or
+copy an existing issue and use it as a template.
+
+Otherwise the [upstream guide on how to create issues](https://github.com/cstate/cstate/wiki/Usage#creating-incidents-method-1) is fairly
+thorough and should be followed.
 
 In general, keep in mind that the `date` field is when the issue
 *started*, not when you posted the issue, see [this feature
 request](https://github.com/cstate/cstate/issues/168) asking for an explicit "update" field.
 
+Also note that you can add `draft: true` to the front-matter (the
+block on top) to keep the post from being published on the front page
+before it is ready.
+
 ## Uploading site to the static mirror system
 
 The `status.torproject.org` site currently lives in the [static mirror