diff --git a/README.md b/README.md
index ede08ba..8ea9799 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,50 @@
-## Beamer mtheme
+## Metropolis
+
+Metropolis is a simple, modern Beamer theme suitable for anyone to use. It tries to minimize noise and maximize space for content; the only visual flourish it offers is an (optional) progress bar added to each slide. The core design principles of the theme were described in a blog post [here](http://bloerg.net/2014/09/20/a-modern-beamer-theme.html).
 
-The *mtheme* is a Beamer theme with minimal visual noise. The core design principles
-of the theme were described in a [blog post](http://bloerg.net/2014/09/20/a-modern-beamer-theme.html).
 Not convinced? Have a look at the [demo slides](demo.pdf).
 
 ![Sample](http://i.imgur.com/Bxu52fz.png)
 
-For further information take a look at the [manual](mtheme.pdf).
+
+## Installation
+
+Installing \themename{}, like any Beamer theme, involves four easy steps:
+
+1. **Download the source** with a `git clone` of the [Metropolis repository](https://github.com/matze/mtheme) or as a [zip archive](https://github.com/matze/mtheme/archive/master.zip) of the latest development version.
+
+2. **Compile the style files** by running `make sty` inside the downloaded
+    directory. (Or run LaTeX directly on `source/metropolistheme.ins`.)
+
+3. **Move the resulting `*.sty` files** to the folder containing your presentation. To use Metropolis with many presentations, run `make install` or move the `*.sty` files to a folder in your TeX path instead.
+
+4. **Use the theme for your presentation** by declaring `\usetheme{m}` in
+    the preamble of your Beamer document.
+
+
+## Usage
+
+The following code shows a minimal example of a Beamer presentation using \themename.
+
+```latex
+\documentclass{beamer}
+\usetheme{m}                     % Use metropolis theme
+\title{A minimal example}
+\date{\today}
+\author{Matthias Vogelgesang}
+\institute{Centre for Modern Beamer Themes}
+\begin{document}
+  \maketitle
+  \section{First Section}
+  \begin{frame}{First Frame}
+    Hello, world!
+  \end{frame}
+\end{document}
+```
+
+Detailed information on using Metropolis can be found in the [manual](doc/metropolistheme.pdf).
+
 
 ## License
 
-The theme itself is licensed under a [Creative Commons Attribution-ShareAlike
-4.0 International License](http://creativecommons.org/licenses/by-sa/4.0/). This
-means that if you change the theme and re-distribute it, you *must* retain the
-copyright notice header and license it under the same CC-BY-SA license. This
-does not affect the presentation that you create with the theme.
+The theme itself is licensed under a [Creative Commons Attribution-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-sa/4.0/). This means that if you change the theme and re-distribute it, you *must* retain the copyright notice header and license it under the same CC-BY-SA license. This does not affect the presentation that you create with the theme.
diff --git a/doc/metropolistheme.dtx b/doc/metropolistheme.dtx
index 5499759..a445a92 100644
--- a/doc/metropolistheme.dtx
+++ b/doc/metropolistheme.dtx
@@ -86,66 +86,103 @@
 \newcommand{\themename}{\textsc{metropolis}\xspace}
 
 \GetFileInfo{beamerthemem.dtx}
-\title{Modern Beamer Presentations\\with the\\\themename package}
+\title{Modern Beamer Presentations with the \themename{} package}
 \author{Matthias Vogelgesang \\ \url{matthias.vogelgesang@gmail.com}}
 \date{v0.x.x}
 
 \begin{document}
 
 \maketitle
+\tableofcontents
 
 \section{Introduction}
 
-Beamer is an awesome way to make presentations with LaTeX. But the stock themes
-do not necessarily look particularly nice and the custom themes often scream
-“Beamer” at first sight. The goal of \themename is to provide a modern Beamer
-theme with minimal visual noise. It provides section slides with a neat progress
-bar and it is intended to be used with
+Beamer is an awesome way to make presentations with LaTeX, but its theme
+selection is surprisingly sparse. The stock themes share an aesthetic that is
+now overused and can be a little cluttered, and the few distinctive custom
+themes available are often specialized for a particular corporate or
+institutional brand.
+
+The goal of \themename{} is to provide a simple, modern Beamer theme suitable
+for anyone to use. It tries to minimize noise and maximize space for content;
+the only visual flourish it offers is an (optional) progress bar added to each
+slide or to the section slides.
+
+By default, \themename{} uses
 \href{https://www.mozilla.org/en-US/styleguide/products/firefox-os/typeface/}
 {Fira Sans}, a gorgeous typeface commissioned by Mozilla and designed by
-\href{http://www.carrois.com/fira-3-1/}{Carrois}. Hence to get the best results
-you should have installed the Fira typeface and use XeTeX to typeset your
-slides. Nevertheless this is no hard dependency. The theme also works fine with
-pdfTeX and the Computer Modern typeface.
+\href{http://www.carrois.com/fira-3-1/}{Carrois}. For best results, you will
+need the Fira typeface installed and use Xe\LaTeX{} to typeset your slides.
+However, \themename{} can also be used other typefaces and \LaTeX{} build
+systems.
 
-The codebase is maintained on \href{https://github.com/matze/mtheme}{GitHub}.
-So if you have issues, find mistakes in the manual or want to contribute – to
-make the theme even better – get in touch there.
+\themename's codebase is maintained on \href{https://github.com/matze/mtheme}
+{GitHub}. If you have issues, find mistakes in the manual or want to help make
+the theme even better, please get in touch there. The
+\href{https://github.com/matze/mtheme/graphs/contributors}
+{full list of contributors} already contains over a dozen names!
 
 
 \section{Getting Started}
 
-\subsection{Installation}
+\subsection{Installing from GitHub}
 
-The \themename theme uses Make as build system. Hence the installation is very
-straight forward. Simply type
-\begin{lstlisting}
-$ make
-$ make install
-\end{lstlisting}
-in the top directory and all the files will be created and installed on your
-computer. The complete list of make rules is as follows:
+Installing \themename{}, like any Beamer theme, involves four easy steps:
+\begin{description}
+  \item[Download the source] with a |git clone| of the
+    \href{https://github.com/matze/mtheme}{\themename{} repository} or as a
+    \href{https://github.com/matze/mtheme/archive/master.zip}{zip archive}
+    of the latest development version.
+
+  \item[Compile the style files] by running |make sty| inside the downloaded
+    directory. (Or run \LaTeX{} directly on |source/metropolistheme.ins|.)
+
+  \item[Move the resulting |*.sty| files] to the folder containing your
+    presentation. To use \themename{} with many presentations, run
+    |make install| or move the |*.sty| files to a folder in your \TeX{} path
+    instead.
+
+  \item[Use the theme for your presentation] by declaring |\usetheme{m}| in
+    the preamble of your Beamer document.
+\end{description}
+
+\themename{} uses the Make build system to offer the following installation
+options for advanced users:
 
 \begin{description}
-  \item[all] \hfill \\
-  Build the theme, the manual and the demo presentation.
-  \item[install] \hfill \\
-  Install the theme into your local texmf folder.
-  \item[uninstall] \hfill \\
-  Remove the theme from your local texmf folder.
-  \item[sty] \hfill \\
-  Creat the package files.
-  \item[doc] \hfill \\
-  Build the documentation.
-  \item[demo] \hfill \\
-  Build the demo presentation.
-  \item[demo-min] \hfill \\
-  Build the minimal demo presentation.
-  \item[ctan] \hfill \\
-  Create a package for CTAN distribution.
+  \item[|make sty|] builds the theme style files.
+  \item[|make doc|] builds this documentation manual.
+  \item[|make demo|] builds a demo presentation to test the features of
+    \themename{}.
+  \item[|make all|] builds the theme, manual, and demo presentation.
+  \item[|make clean|] removes the files generated by |make all|.
+  \item[|make install|] installs the theme into your local texmf folder.
+  \item[|make uninstall|] removes the theme from your local texmf folder.
+  \item[|make ctan|] creates a package for CTAN distribution.
 \end{description}
 
 
+\subsection{A Minimal Example}
+
+The following code shows a minimal example of a Beamer presentation using \themename.
+
+\begin{lstlisting}
+\documentclass{beamer}
+\usetheme{m}                     % Use metropolis theme
+\title{A minimal example}
+\date{\today}
+\author{Matthias Vogelgesang}
+\institute{Centre for Modern Beamer Themes}
+\begin{document}
+  \maketitle
+  \section{First Section}
+  \begin{frame}{First Frame}
+    Hello, world!
+  \end{frame}
+\end{document}
+\end{lstlisting}
+
+
 \subsection{Dependencies}
 
 \begin{itemize}
@@ -172,29 +209,7 @@ $ pandoc -t beamer --latex-engine=xelatex -V theme:m -o output.pdf input.md
 \end{lstlisting}
 
 
-\subsection{A Minimal Example}
 
-To get started with the theme is very simple. The following code shows a
-minimal example of a Beamer presentation using \themename.
-
-\begin{lstlisting}
-\documentclass[10pt]{beamer}
-\usetheme{m}                          % load mtheme
-\title{A modern beamer theme}         % define title
-\date{\today}                         % define date
-\author{Matthias Vogelgesang}         % define author
-\institute{Institute}                 % define institute
-\begin{document}
-\maketitle                            % create titlepage
-\section{First Section}               % create section
-\begin{frame}{First Frame}            % first frame
-  Lorem ipsum dolor sit amet, ...
-\end{frame}
-\begin{frame}{Second Frame}           % second frame
-  Lorem ipsum dolor sit amet, ...
-\end{frame}
-\end{document}
-\end{lstlisting}
 
 \section{Customization}
 \subsection{Package options}
@@ -344,11 +359,6 @@ license it under the same CC-BY-SA license. This does not affect the
 presentation that you create with the theme.
 
 
-\section{Contributors}
-
-For a full list of contributors please visit the
-\href{https://github.com/matze/mtheme/graphs/contributors}{GitHub Repository}.
-
 
 \section{Implementation}