A single sentence per line

@@ -47,0 +55,4 @@
+#### Add a Blog Entry
+
+Blog posts (the archetype is called `article`) should be used for information that will be relevant for a longer period, for example explanations about technical, political or cultural topics.
+Articles will be shown in chronological order on the [blog main page](https://hamburg.ccc.de/blog/), until newer posts push them down.

@@ -47,0 +64,4 @@
+```
+
+If you want to create a blog post from scratch, or convert an event into a blog post, see the frontmatter data in [themes/ccchh/archetypes/article.md](themes/ccchh/archetypes/article.md).
+In particular, you need to set `categories: article` and remove any `date:` or `location:`.

@@ -47,0 +65,4 @@
+
+If you want to create a blog post from scratch, or convert an event into a blog post, see the frontmatter data in [themes/ccchh/archetypes/article.md](themes/ccchh/archetypes/article.md).
+In particular, you need to set `categories: article` and remove any `date:` or `location:`.
+Note that `publishDate:` is fine, as it determines when the content will start appearing on the the site.

@@ -48,3 +71,2 @@
 
-There are two basic types of posts: Events and articles.
-Events will be shown on the home page from their publishing date until they have happened and shall be used for things which happen at a certain date.
+Events will be shown on the home page from the frontmatter `publishDate` until the `date:`.

@@ -68,2 +82,2 @@
-hugo new content --kind article blog/yyyy/yyyy-mm-dd-your-article-title/index.md
-```
+If you want to create an event from scratch, or convert a blog post into an event, see the frontmatter data in [themes/ccchh/archetypes/event.md](themes/ccchh/archetypes/event.md).
+In particular, you need to set `categories: event`, `date:` for the date of the event, and `location: Z9` (or whereever your event takes place).

@@ -47,0 +50,4 @@
+Hugo and the template set distinguish between these two types based on frontmatter information.
+When manually creating content, you need to take extra care to use the correct frontmatter data.
+See the link to the Hugo archetypes below for details.
+If at all possible, use `hugo new content` with the appropriate parameters to create the new content file correctly.

@@ -47,0 +56,4 @@
+* `date`: the date displayed for this content.
+  For events, that should be when the event takes place; for blog posts, it is when the post was written.
+* `publishDate`: the date and time the content should be published.
+  Note that the date is evaluated only during site generation, so if you pick a date in the future, it might take up to 24 hours longer before your content appears.

@@ -47,0 +64,4 @@
+#### Add a Blog Entry
+
+Blog posts (the archetype is called `article`) should be used for information that will be relevant for a longer period, for example explanations about technical, political or cultural topics.
+Articles will be shown for a few days on the home page, and in chronological order on the [blog main page](https://hamburg.ccc.de/blog/), until newer posts push them down.