robquant
diff --git a/‎docs/session.rst‎
Lines changed: 6 additions & 0 deletions b/‎docs/session.rst‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎webuntis/objects.py‎
Lines changed: 21 additions & 7 deletions b/‎webuntis/objects.py‎
Lines changed: 21 additions & 7 deletions
diff --git a/‎webuntis/session.py‎
Lines changed: 7 additions & 6 deletions b/‎webuntis/session.py‎
Lines changed: 7 additions & 6 deletions
@@ -29,3 +29,9 @@ Things you can do with the API
     .. automethod:: statusdata
     .. automethod:: subjects
     .. automethod:: teachers
+    .. automethod:: statusdata
+    .. automethod:: lastImportTime
+    .. automethod:: substitutions
+    .. automethod:: timegridUnits
+    .. automethod:: students
+
@@ -461,7 +461,7 @@ def is_current(self):
         Boolean, check if this is the current schoolyear::
 
             >>> import webuntis
-            >>> s = webuntis.Session()
+            >>> s = webuntis.Session(...).login()
             >>> y = s.schoolyears()
             >>> y.current.id
             7
@@ -552,7 +552,7 @@ class ColorInfo(Result, ColorMixin):
     An object containing information about a lesson type or a period code::
 
         >>> import webuntis
-        >>> s = webuntis.Session()
+        >>> s = webuntis.Session(...).login()
         >>> lstype = s.statusdata().lesson_types[0]
         >>> lstype.name
         'ls'
@@ -589,7 +589,10 @@ class StatusData(Result):
     @lazyproperty
     def lesson_types(self):
         """A list of :py:class:`ColorInfo` objects, containing
-        information about all lesson types defined"""
+        information about all lesson types defined
+
+        :rtype: List[ColorInfo]
+        """
         return [
             ColorInfo(parent=self, data=data)
             for data in self._data[u'lstypes']
@@ -598,7 +601,10 @@ def lesson_types(self):
     @lazyproperty
     def period_codes(self):
         """A list of :py:class:`ColorInfo` objects, containing
-        information about all period codes defined"""
+        information about all period codes defined
+
+        :rtype: List[ColorInfo]
+        """
         return [
             ColorInfo(parent=self, data=data)
             for data in self._data[u'codes']
@@ -613,7 +619,7 @@ def date(self):
         """
         get timestamp as python datetime object
 
-        :return: timestamp
+        :return: datetime.datetime
         """
         return datetime.datetime.fromtimestamp(self._data / 1000)
 
@@ -628,12 +634,17 @@ def type(self):
              add      additional period
              shift    shifted period
              rmchg    room change
+
+        :rtype: str
         """
         return self._data[u'type']
 
     @lazyproperty
     def reschedule_start(self):
-        """The start of the rescheduled substitution (or None)"""
+        """The start of the rescheduled substitution (or None)
+
+        :return: datetime.datetime
+        """
         try:
             return datetime_utils.parse_datetime(self._data[u'reschedule'][u'date'],
                                                  self._data[u'reschedule'][u'startTime'])
@@ -642,7 +653,10 @@ def reschedule_start(self):
 
     @lazyproperty
     def reschedule_end(self):
-        """The end of the rescheduled substitution (or None)"""
+        """The end of the rescheduled substitution (or None)
+
+        :return: datetime.datetime
+        """
         try:
             return datetime_utils.parse_datetime(self._data[u'reschedule'][u'date'],
                                                  self._data[u'reschedule'][u'endTime'])
 
@@ -275,15 +275,15 @@ def statusdata(self):
 
     @result_wrapper
     def lastImportTime(self):
-        """
+        """Information about the last change made.
 
         :rtype: py:class:`webuntis.objects.TimeStampObject`
         """
         return objects.TimeStampObject, 'getLatestImportTime', {}
 
     @result_wrapper
     def substitutions(self, start, end, departmentId=0):
-        """Information about substitutions
+        """Get all substitutions.
 
 
         :type start: :py:class:`datetime.datetime` or  :py:class:`datetime.date` or int
@@ -292,8 +292,8 @@ def substitutions(self, start, end, departmentId=0):
         :type end: :py:class:`datetime.datetime` or  :py:class:`datetime.date` or int
         :param end: The end of the time period.
 
-        :param departmentId:  int
-        :return:
+        :param departmentId:  int, set to 0 for all departments or  if not applicable
+
         :rtype: :py:class:`webuntis.objects.SubstitutionList`
         """
 
@@ -316,15 +316,16 @@ def substitutions(self, start, end, departmentId=0):
 
     @result_wrapper
     def timegridUnits(self):
-        """
+        """Information about the Timegrid.
 
+        :return:
         :rtype: :py:class:`webuntis.objects.TimegridObject`
         """
         return objects.TimegridObject, 'getTimegridUnits', {}
 
     @result_wrapper
     def students(self):
-        """
+        """Get all students
 
         :rtype:  :py:class:`webuntis.objects.StudentsList`
         """