minor: improve docstrings

Author: dimitri-yatsenko

datajoint/autopopulate.py

@@ -26,10 +26,10 @@ class AutoPopulate:
     @property
     def key_source(self):
         """
-        :return: the query expression whose primary key values are passed, sequentially, to the
-                ``make`` method when populate() is called.
-                The default value is the join of the parent relations.
-                Users may override to change the granularity or the scope of populate() calls.
+        :return: the query expression that yields primary key values to be passed,
+        sequentially, to the ``make`` method when populate() is called.
+        The default value is the join of the parent relations.
+        Users may override to change the granularity or the scope of populate() calls.
         """
         def _rename_attributes(table, props):
             return (table.proj(

datajoint/table.py

@@ -55,7 +55,8 @@ class Table(QueryExpression):
     _table_name = None  # must be defined in subclass
     _log_ = None  # placeholder for the Log table object
 
-    # These properties must be set by the schema decorator (schemas.py) at class level or by FreeTable at instance level
+    # These properties must be set by the schema decorator (schemas.py) at class level
+    # or by FreeTable at instance level
     database = None
     declaration_context = None