Update README.md

README.md

 This repository contains all the sources needed to maintain the Debian blog
-https://bits.debian.org
+https://bits.debian.org and instructions to build the site.
 
 
-Contents
---------
-Makefile
-pelicanconf.py  configuration file for pelican
-publishconf.py  publishing configuration file for pelican
-theme-bits/     contains the blog's theme and the templates used.
-content/        contains the source for the contents
-content/pages/  contains the static pages
-content/2013/   contains the blog posts for 2013
-output/         should be always empty, it is for generate the blog locally
+## Contents
 
-Software
---------
-Pelican is packaged in Debian Jessie.
+		Makefile
+		pelicanconf.py  configuration file for pelican
+		publishconf.py  publishing configuration file for pelican
+		theme-bits/     contains the blog's theme and the templates used.
+		content/        source files for the posts
+		content/pages/  source files the static pages
+		content/2013/   source files for the blog posts from 2013
+		discarded/      source files for discarded blog posts
+		output/         should be always empty, it is for generate the blog locally
+		plugins/        pelican plugins
 
-Updating the blog in dillon.d.o
--------------------------------
 
-This is only valid for people in the publicity group (the group of Linux users in Debian machines).
+## Testing locally
 
-1. Log in dillon.debian.org and get a copy of the bits repository or
-update your current copy:
+* Install pelican
 
-$ git clone https://salsa.debian.org/publicity-team/bits.git
+* Clone this repository
 
-2. Execute:
+		$ git clone https://salsa.debian.org/publicity-team/bits.git && cd bits
 
-$ cd bits
-$ make mpublish
+* Build the site:
 
-This will remove all the files at /srv/bits-master.debian.org/htdocs and will
-regenerate a new copy of the website. Then, it'll run the script:
+		$ make html
 
-$ /usr/local/bin/static-update-component bits.debian.org
+* Serve it locally to see if it's rendered properly:
 
-and propagate the blog update to all the mirrors.
+		$ make serve
+
+* Open <http://localhost:8000> in your browser.
+
+
+## Updating the blog in dillon.d.o
+
+This is only valid for people in the publicity group (the group of Linux
+users in Debian machines).
+
+* Log in dillon.debian.org and get a copy of the bits repository
+or update your current copy:
+
+		$ git clone https://salsa.debian.org/publicity-team/bits.git
+
+* Execute:
+
+		$ cd bits
+		$ make mpublish
+
+This will remove all the files at `/srv/bits-master.debian.org/htdocs`
+and will regenerate a new copy of the website and propagate update
+to all the static mirrors.