README.md in mere-blog-theme-0.2.1 vs README.md in mere-blog-theme-0.3

@@ -32,10 +32,11 @@
 
 ## Usage
 
 * [Blog Setup](#blog-setup)
 * [Posts](#posts)
+    * [Post Intro](#post-intro)
 * [Homepage](#homepage)
 * [Authors](#authors)
 * [Google Analytics](#google-analytics)
 
 ### Blog Setup
@@ -64,9 +65,24 @@
 image: /img/home.jpg
 author: C.S. Rhymes
 ```
 
 Wide images will work best, with a minimum width of 1400px. 
+
+#### Post Intro
+
+Version 0.3 allows you to provide a intro and an intro image in your frontmatter. When creating your post add a short `intro` text an `intro_image` as a path to an image and then specify the `intro_image_ratio` which should be a [Bulma image](https://bulma.io/documentation/elements/image/) class. 
+
+```yaml
+layout: post
+title: Post with Intro
+author: Guest Author
+intro: This is the introduction text for this post. It appears large and bold at the top of the post
+intro_image: /img/home.jpg
+intro_image_ratio: is-16by9
+```
+
+Only the intro is required if you want to display it. If you don't want an image then don't specify one and just the intro text will display.
 
 ### Homepage
 
 Finally, configure the homepage by creating an `index.html` page and configure the frontmatter with the layout of homepage, the title, subtitle (optional) and the image. You can set the hero_height to is-large if you want to make the homepage header a bit larger.