DOCS: Improve the reference docs for the API

[HTenkanen]

Geopandas has a nice and clean way to document the API with separate pages to give an overview and then more detailed docs for given function/method, e.g: https://geopandas.readthedocs.io/en/latest/docs/reference/geodataframe.html

Something similar would be nice to have for pyrosm as well.