Update docs and fix bugs (#149)

Improved the docs for the 3 main Tactility projects. I also fixed some inaccuracies and bugs in certain APIs as I went through the code.

TactilityHeadless/Source/TactilityHeadless.h

@@ -7,14 +7,20 @@
 
 namespace tt {
 
+/** Initialize the hardware and started the internal services. */
 void initHeadless(const hal::Configuration& config);
 
+/** Provides access to the dispatcher that runs on the main task.
+ * @warning This dispatcher is used for WiFi and might block for some time during WiFi connection.
+ * @return the dispatcher
+ */
 Dispatcher& getMainDispatcher();
 
 } // namespace
 
 namespace tt::hal {
 
+/** Can be called after initHeadless() is called. Will crash otherwise. */
 const Configuration& getConfiguration();
 
 } // namespace