Skip to content

Commit

Permalink
Merge pull request #40 from aariops/blog-post
Browse files Browse the repository at this point in the history
developed on and rearranged the blog post template - Fixes issue #18
  • Loading branch information
booyaa authored May 10, 2018
2 parents b1a557a + a8a998c commit 91cf343
Showing 1 changed file with 28 additions and 20 deletions.
48 changes: 28 additions & 20 deletions guides/blog_post_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,34 +2,42 @@

Havi Hoffman has kindly given us permission to use the Mozilla Hacks blog post template as a reference point.

**Working title:** Name of Post
**Attributed Author:** Author Name
**One line bio:**
### Setting things up

Defining a few things in the beginning can help you create content that works better for the reader.

**Audience:** Web Developers? Hardware/Software Partners? MR Press?
**Timing:**
**Channel:** Medium? Mixed Reality Blog?
**Visual Assets:** Videos? Pictures?
**FAQ/other materials needed:**
- **Audience:** This post is aimed at the Rust Content Team, so I can write things a bit more technical. If I was writing for beginners, I would have to keep things simpler.
- **Visual Assets:** Are there videos or pictures or memes that can help you get your message across? Get them ready in advance.
- **FAQ/other materials needed:** The same goes for other special content you may like to share, such as FAQs or podcasts, etc.

## Goals
*Some of the text below is dummy text, but it should guide your through writing a blog post. You should replace the dummy text with your own content and, probably, get rid of (or adapt) titles and headers.*

## Summarize goals for this post
## Template

## Top Messages to Communicate:
1)
2)
3)
- **Working title:** How To Write a Nice Blog Post
- **Attributed Author:** Rust Community Dummy
- **One line bio:** Rust Community Dummy has been a great bot for three months. Loves Rust and working collaboratively.

## CTA:
Can be: download, share this, learn more, give feedback, create/submit something
### Goals

Have you ever wondered what it would be like to have an amazing blog post template? On this post we'll guide you through the basics of any great [Read Rust](https://readrust.net/) blog post. We'll show you how you can get your message across in an easy manner and how to keep people interested in what you're sharing.

### Telling a Story

## Best Blogs:
When I was a kid Rust Community Dummy life could get hard sometimes. I used to get lots of sprockets stuck. However, when Rust Programming Language came into my life, things got blazingly fast and my thread safety was finally guaranteed. Let me tell you how it came to this. It all started with a blog post

- Are concise and easy to read for a general audience (unless targeted at devs)
- Tell compelling, colorful stories about how the tech/policy/thing impacts people’s lives
- Don’t bury the lede!
![rust_meme](https://img.memecdn.com/rust-you-complete-me_o_2682031.jpg)

### Top Messages to Communicate:
1. Keep your most important things at the top and then develop the idea
2. A structured post is easier to read and easier to write
3. Telling a story helps to keep readers engaged (and so do images!); a good story tells you about how the tech/policy/thing impacts people’s lives
4. Language should be concise and easy to read for a general audience (unless targeted at devs)
5. Less is more: short sentences are better than long ones

### Call to action (CTA):
Can be: download, share this, learn more, give feedback, create/submit something
In this case, write your own blog post using this template.

## Suggested Basic Outline:

Expand Down

0 comments on commit 91cf343

Please sign in to comment.