improve documentation

doc/allclasses.qdoc

@@ -3,4 +3,5 @@
     \title All guh Classes
 
     \generatelist classes
+    \generatelist overviews
 */

doc/api.qdoc

@@ -0,0 +1,9 @@
+/*!
+    \page api.html
+    \title The guh API's
+    
+    \l{JSON-RPC API}
+    
+    \l{REST API}
+    
+*/

doc/guh.qdoc

@@ -2,31 +2,41 @@
     \page index.html
     \title guh - Developer Documentation
 
-    \section1 Summary
+    \section1 Overview
     The guh backend service consists of three main modules:
 
     \list
-        \li \l{libguh}
+        \li \l{guhserver}{The guh server}
+            \list
+                \li \l{guhserver}{The guh server namespace}
+                \li \l{Rules}
+            \endlist
+        \li \l{libguh}{The guh library}
             \list
                 \li \l{Types}{Types used in the guh system}
                 \li \l{Device Plugins}{The Device Plugin API}
-                \li \l{Hardware Resources}{Hardware Resources}
+                \li \l{Hardware Resources}{Hardware resources available for plugins}
             \endlist
-        \li \l{guhserver}
-            \list
-                \li \l{guh Core}
-                \li \l{JSONRPC Interface}
-                \li \l{Rules}
-            \endlist
-        \li \l{Plugins}.
+        \li \l{Plugins}{The guh plugins}
             \list
                 \li \l{RF 433 MHz Plugins}
                 \li \l{Service Plugins}
                 \li \l{Network Plugins}
-            \endlist
+            \endlist        
     \endlist
 
-    \section2 Quicklinks
+    \section1 API's
+    \list
+        \li \l{JSON-RPC API}
+        \li \l{https://github.com/guh/guh/wiki/REST-Api-documentation}{REST API}
+    \endlist
+
+    \section1 How To's
+    \list
+        \li How to write a plugin
+    \endlist
+
+    \section1 Quicklinks
     \list
         \li \l{All guh Classes}        
         \li \l{All Modules}

doc/guhcore.qdoc

@@ -2,6 +2,6 @@
     \page guhcore-index.html
     \title guh Core
 
-    \annotatedlist core
+    \annotatedlist server
 */
 

doc/jsonrpc.qdoc

@@ -1,6 +1,6 @@
 /*!
     \page jsonrpc.html
-    \title JSONRPC Interface
+    \title JSON-RPC API
     \ingroup jsonrpc
 
     \brief The JSON RPC interface represents a TCP socket connection using plaintext string communication.

doc/libguh.qdoc

@@ -1,6 +1,6 @@
 /*!
     \module libguh
-    \title libguh
+    \title The guh library
 
     \section1 Types
     \annotatedlist types

doc/rest.qdoc

@@ -0,0 +1,9 @@
+/*!
+    \page rest.html
+    \title REST API
+
+    \brief The REST API description of the guh server.
+
+    
+
+*/

server/websocketserver.cpp

@@ -25,6 +25,8 @@
     \ingroup core
     \inmodule server
 
+    \note The WebSocketServer is only available for builds with Qt version greater than Qt 5.3.0!
+
     The websocket server provides a server for websocket clients based on
     \l{http://tools.ietf.org/html/rfc6455}{Protocol Version 13}. The default
     port for the websocket server is 4444, which is according to this