Update README.md
diff --git a/README.md b/README.md
index 9cb6a34..1ec87c1 100644
--- a/README.md
+++ b/README.md
@@ -17,11 +17,11 @@
 
 The site contains a packaged version of the JDO API javadoc. It can be updated as follows:
 
-* Create the javadoc jar (e.g. jdo-api-3.2-javadoc.jar) in the db-jdo repository by calling `mvn clean install -Papache-release` in the api submodule.
+* Create the javadoc jar (e.g. jdo-api-3.2-javadoc.jar) in the db-jdo repository by calling ```mvn clean install -Papache-release``` in the api submodule.
 * Create a new folder in the javadoc resources directory e.g. `src/main/resources/javadoc/api32`.
 * Copy the javadocs jar into the new folder, e.g. `cp  jdo-api-3.2-javadoc.jar  src/main/resources/javadoc/api32`.
-* Create a new subfolder, e.g. `src/main/resources/javadoc/api32/jdo-api-3.2-javadoc`
-* Unpack the javadoc jar in the subfolder
+* Create a new subfolder, e.g. `src/main/resources/javadoc/api32/jdo-api-3.2-javadoc`.
+* Unpack the javadoc jar in the subfolder.
 * Edit javadoc.adoc under src/main/asciidoc and create a new section 'JDO 3.2 javadoc'.
 * Add two links: one referring index.html in the subfolder and one referring the javadoc jar.