diff --git a/flyteidl/README.rst b/flyteidl/README.rst
index 13ec883437..21bc60d71e 100644
--- a/flyteidl/README.rst
+++ b/flyteidl/README.rst
@@ -5,26 +5,25 @@ This is one of the core repositories of Flyte and contains the Specification of
 the Flyte Lanugage. The Specification is maintained using Googles fantastic
 Protcol buffers library. The code and docs are auto-generated.
 
- - [flyte.org](https://flyte.org)
- - [Flyte Docs](http://flyte.readthedocs.org/)
- - [FlyteIDL Docs](http://flyteidl.readthedocs.org)
+* [flyte.org](https://flyte.org)
+* [Flyte Docs](http://flyte.readthedocs.org/)
+* [FlyteIDL Docs](http://flyteidl.readthedocs.org)
 
 Generate Code from protobuf
 ----------------------------
-#. Make sure docker is installed locally.
-#. Once installed run, ``make generate`` to generate all the code and mock
-   client for FlyteAdmin Service
+#. Run ``make download_tooling`` to install generator dependencies
 
    .. prompt:: bash
 
-    make generate
+   make download_tooling
 
-#. You might have to run, ``make download_tooling`` to install generator
-   dependencies
+#. Make sure docker is installed locally.
+#. Once installed, run ``make generate`` to generate all the code and mock
+   client for FlyteAdmin Service
 
    .. prompt:: bash
 
-   make download_tooling
+    make generate
 
 #. To add new dependencies for a doc, modify ``doc_requirements.in`` and then