diff --git a/README.rst b/README.rst
index 2c6f6e350dcee3312de0b6fb590eb3be8f1066b9..a92c7f558e275f48f79a7cd60a67bcfd20846b19 100644
--- a/README.rst
+++ b/README.rst
@@ -38,11 +38,11 @@ Then they must arrive at destination not later than the committed arrival time.
 very complex. In such a complex environment cooperation is essential. Thus, agents must learn to cooperate in a way that all trains (agents) arrive on time.
 
 
-.. image:: docs/gifs/complex.gif
+.. image:: https://i.imgur.com/KQTVPto.gif
   :align: center
   :width: 600px
 
-.. image:: docs/gifs/many_agents.gif
+.. image:: https://i.imgur.com/xgWGRse.gif
   :align: center
   :width: 600px
 
diff --git a/docs/flatland.core.grid.rst b/docs/flatland.core.grid.rst
new file mode 100644
index 0000000000000000000000000000000000000000..e5ac277f8d1e173f620e85a498ce950e5b1f3ad8
--- /dev/null
+++ b/docs/flatland.core.grid.rst
@@ -0,0 +1,62 @@
+flatland.core.grid package
+==========================
+
+Submodules
+----------
+
+flatland.core.grid.grid4 module
+-------------------------------
+
+.. automodule:: flatland.core.grid.grid4
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+flatland.core.grid.grid4\_astar module
+--------------------------------------
+
+.. automodule:: flatland.core.grid.grid4_astar
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+flatland.core.grid.grid4\_utils module
+--------------------------------------
+
+.. automodule:: flatland.core.grid.grid4_utils
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+flatland.core.grid.grid8 module
+-------------------------------
+
+.. automodule:: flatland.core.grid.grid8
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+flatland.core.grid.grid\_utils module
+-------------------------------------
+
+.. automodule:: flatland.core.grid.grid_utils
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+flatland.core.grid.rail\_env\_grid module
+-----------------------------------------
+
+.. automodule:: flatland.core.grid.rail_env_grid
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: flatland.core.grid
+    :members:
+    :undoc-members:
+    :show-inheritance: