Doc updates

[htgoebel]

• Update documentation about entry-points (closes #325)
• Add section about how to build the documentation locally.
• Use sphinx_rtd_theme when building docs locally.

[htgoebel]

@reinout Updated this one.