Getting Started

Author: Conengmo

docs/index.rst

@@ -29,12 +29,23 @@ Contents
 ==================================
 
 .. toctree::
-   :maxdepth: 3
-   :caption: Contents:
+   :maxdepth: 1
+   :caption: Getting Started
 
    installing
+   overview
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents
+
    Quickstart.md
    flask
+
+.. toctree::
+   :maxdepth: 1
+   :caption: API reference
+
    modules
    plugins
 

docs/installing.rst

@@ -1,24 +1,29 @@
-Installing
-==========
+Installation
+============
+Folium can be installed using
 
-Requirements
-------------
 ::
 
- branca, jinja2 and requests.
-
-Some functionalities may require extra dependencies
-`numpy`, `pandas`, `geopandas`, `altair`, etc.
+$ pip install folium
 
+If you are using the Conda package manager, the equivalent is
 
-Installation
-------------
 ::
 
-$ pip install folium
+$ conda install folium -c conda-forge
 
-or
 
-::
+Dependencies
+============
 
-$ conda install folium -c conda-forge
+Folium has the following dependencies, all of which are installed automatically
+with the above installation commands:
+
+- python 3.6 or newer
+- branca
+- Jinja2
+- Numpy
+- Requests
+
+Additional packages may be necessary for some functionality. It will say so in
+the documentation where that's the case.

docs/overview.md

@@ -0,0 +1,25 @@
+Overview
+==========
+
+Folium is a geographical visualization library for Python, based on
+[Leaflet.js](https://leafletjs.com/).
+
+Here's a basic example of creating a map:
+
+```{code-cell} ipython3
+import folium
+
+m = folium.Map(location=[45.5236, -122.6750])
+```
+
+If you are in a Jupyter Notebook, you can display it like this:
+
+```{code-cell} ipython3
+m
+```
+
+Or you can save it as an HTML file:
+
+```{code-cell} ipython3
+m.save("index.html")
+```

docs/plugins.rst

@@ -1,4 +1,4 @@
-:mod:`plugins`
---------------
+Plugins
+=======
 
 .. automodule:: folium.plugins