humanutility / humanutility.github.io Goto Github PK

The people publishing to the blog post are not necessarily going to be technical.

We need a README that documents in detail how to go about publishing a blog post.

This should likely be in two steps:

1. How to set the project up locally so you can write posts
2. How to actually write a post (and what the process is for it to end up on the blog)

For the second we'll likely need to explain how to:

• generate the file / where to look for it
• define the necessary metadata
• use markdown
• check it locally in the browser
• commit your changes
• submit a pull request

This doesn't need to be very elaborate, but it would be helpful to define:

• where to write down blog post ideas
• how to go from idea to published post

Someone recently characterized the Human Utility project as "a button that takes my money", which is a tragically incomplete characterization of the project. The purpose of the blog is to help bring a richer context and understanding of what the project is accomplishing, and how it is doing it.

People understand data, but they believe stories. —Mike Hoye

As a starting point, we will need:

• a simple, attractive, usable design
• separate template types for different types of content (probably depends on the content strategy, but at the very least, a "short post", a "long post", and a "profile", I think)
• content strategy (#3)
• content workflow (#4)
• sign up form for the newsletter
• documentation (#2)

Note: We can edit and update this issue to help organize the work on this project.

The whole idea of a content strategy blew my mind when I first learned about it. Without a content strategy, each post is a unique snowflake that you have to invent from scratch. With a content strategy you define high level categories of similar content, and it becomes much easier to come up with ideas within a category.

Tiffani mentioned a bunch of different types of content that is relevant already. This could be a place to start writing these down.

E.g. the human stories behind the bills that get paid, how policy affects things, interacting with government, interacting with the utility companies, ...

Also, for each idea for a blog post or story, it could be worth considering what larger category of content this story belongs to, as that might represent a whole new rich stream of ideas.