doc: add a page with examples.

doc/python/conf.py

@@ -47,7 +47,9 @@ INPUT_MODULES = [corrade, magnum]
 INPUT_PAGES = [
     'pages/index.rst',
     'pages/building.rst',
-    'pages/api-conventions.rst'
+    'pages/api-conventions.rst',
+
+    '../../../magnum-examples/doc/python/examples.rst'
 ]
 INPUT_DOCS = [
     'corrade.containers.rst',
@@ -70,6 +72,7 @@ PLUGINS = [
     'm.dox',
     'm.gh',
     'm.htmlsanity',
+    'm.images',
     'm.link',
     'm.math',
     'm.sphinx'

doc/python/pages/index.rst

@@ -45,7 +45,8 @@ details.
 See the :link-ref:`building docs <building.html>` for an installation guide,
 :link-ref:`API convention documentation <api-conventions.html>` and
 :link-ref:`documentation of each module <modules.html>` for more information
-about the actual usage.
+about the actual usage. There are also :link-ref:`examples <examples.html>` to
+give you an idea about how the API feels.
 
 `Contact & support`_
 ====================