Add description of base classes.

skabase/SKAAlarmHandler/SKAAlarmHandler/SKAAlarmHandler.py

@@ -7,7 +7,9 @@
 
 """ SKAAlarmHandler
 
-A generic base device for Alarms for SKA.
+A generic base device for Alarms for SKA. It exposes SKA alarms and SKA alerts as TANGO attributes.
+SKA Alarms and SKA/Element Alerts are rules-based configurable conditions that can be defined over multiple
+attribute values and quality factors, and are separate from the "built-in" TANGO attribute alarms.
 """
 
 # tango imports

skabase/SKABaseDevice/SKABaseDevice/SKABaseDevice.py

@@ -7,7 +7,7 @@
 
 """ SKABASE
 
-A generic base device for SKA.
+A generic base device for SKA. It exposes the generic attributes, properties and commands of an SKA device.
 """
 
 # tango imports

skabase/SKACapability/SKACapability/SKACapability.py

@@ -23,7 +23,7 @@ __all__ = ["SKACapability", "main"]
 
 class SKACapability(SKAObsDevice):
     """
-    Subarray handling device
+    A Subarray handling device. It exposes the instances of configured capabilities.
     """
     __metaclass__ = DeviceMeta
     # PROTECTED REGION ID(SKACapability.class_variable) ENABLED START #

skabase/SKALogger/SKALogger/SKALogger.py

@@ -8,7 +8,8 @@
 
 """ SKALogger
 
-A generic base device for Logging for SKA.
+A generic base device for Logging for SKA. It enables to view on-line logs through the TANGO Logging Services
+ and to store logs using Python logging. It configures the log levels of remote logging for selected devices.
 """
 
 # tango imports

skabase/SKAObsDevice/SKAObsDevice/SKAObsDevice.py

@@ -7,7 +7,8 @@
 
 """ SKAObsDevice
 
-A generic base device for Observations for SKA.
+A generic base device for Observations for SKA. It inherits SKABaseDevice class. Any device implementing
+and obsMode will inherit from SKAObsDevice instead of just SKABaseDevice.
 """
 
 # tango imports

skabase/SKASubarray/SKASubarray/SKASubarray.py

@@ -7,7 +7,8 @@
 
 """ SKASubarray
 
-SubArray handling device
+A SubArray handling device. It allows the assigning/releasing of resources into/from Subarray, configuring
+capabilities, and exposes the related information like assigned resources, configured capabilities, etc.
 """
 
 # tango imports