diff --git a/README.md b/README.md
index 5dbb2902ee231d845de6509cdc082c9f7ae9e14e..4ac7383a40599faec9086f4768814c47d8ed1f79 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,27 @@
-# FreeIPA Ansible roles
+FreeIPA Ansible roles
+=====================
 
-This repository contains [Ansible](https://www.ansible.com/) roles and playbooks to install and uninstall [FreeIPA](https://www.freeipa.org/) servers and clients. A role for replica is in the works, but is not functional so far.
+This repository contains [Ansible](https://www.ansible.com/) roles and playbooks to install and uninstall [FreeIPA](https://www.freeipa.org/) `servers`, `replicas` and `clients`.
 
 **Note**: The ansible playbooks and roles require a configured ansible environment where the ansible nodes are reachable and are properly set up to have an IP address and a working package manager.
 
-## Supported FreeIPA versions
+Supported FreeIPA versions
+--------------------------
 
 For now only FreeIPA versions 4.5 and up are supported. The client role should also be functional with FreeIPA 4.4.
 
-## Supported Distributions
+Supported Distributions
+-----------------------
+
 * RHEL/CentOS 7.4+
 * Fedora 26+
 
-## Roles
-
-[Client](CLIENT.md)
+Roles
+-----
 
-[Server](SERVER.md)
+* [Server](SERVER.md)
+* [Replica](REPLICA.md)
+* [Client](CLIENT.md)
 
+Examples
+--------