Finish documentation

RedFantom · RedFantom · commit 35aa44751d2e · 2019-02-28T18:52:59.000+01:00
diff --git a/docs/index.rst b/docs/index.rst
@@ -10,10 +10,9 @@ interface to the LEDs on the MasterKeys keyboard series.
    :caption: Contents:
 
    source/devices
-   source/contributing
+   source/examples/index
    Documentation: libmk <source/libmk/index>
    Documentation: masterkeys <source/masterkeys/index>
-   source/examples/index
 
 .. |Travis| image:: https://api.travis-ci.com/RedFantom/masterkeys-linux.svg
    :alt: Travis-CI Build Status
diff --git a/docs/source/contributing.rst b/docs/source/contributing.rst
diff --git a/docs/source/examples/ambilight.rst b/docs/source/examples/ambilight.rst
@@ -0,0 +1,11 @@
+AmbiLight
+=========
+
+Fast screenshot capture program that calculates the dominant color
+(average of colors with high hue) visible on the screen and sets it as
+the only color of the keyboard. Is capable of reaching somewhere between
+20 and 30 FPS on most machines.
+
+.. literalinclude:: ../../../examples/ambilight/ambilight.c
+   :language: c
+   :linenos:
diff --git a/docs/source/examples/index.rst b/docs/source/examples/index.rst
@@ -1,4 +1,12 @@
 Examples
 ========
 
+In this section, a set of examples is provided as a simple reference on
+how the libraries may be used in a practical manner. The examples are
+extensively tested and a good way to determine whether building and
+installing the libraries was successful and the library is capable of
+controlling your device.
 
+.. toctree::
+   Photo Viewer: Python <photo>
+   AmbiLight: C <ambilight>
diff --git a/docs/source/examples/photo.rst b/docs/source/examples/photo.rst
@@ -0,0 +1,10 @@
+Photo Viewer
+============
+
+Simple Python program that reads a specified image file and calculates
+a color matrix based on this image by averaging the pixels. The image is
+then set on the keyboard.
+
+.. literalinclude:: ../../../examples/photoviewer/viewer.py
+   :language: python
+   :linenos:
