[base/section] Docstring updates

Author: mpsonntag

odml/base.py

@@ -660,17 +660,17 @@ def create_section(self, name=None, type="n.s.", oid=None, definition=None,
         Creates a new subsection that is a child of this section.
 
         :param name: The name of the section to create. If the name is not
-                 provided, the uuid of the Property is assigned as its name.
-                 Section name is a required attribute.
+                     provided, the object id of the Section is assigned as its name.
+                     Section name is a required attribute.
         :param type: String providing a grouping description for similar Sections.
                      Section type is a required attribute and will be set to the string
                      'n.s.' by default.
         :param oid: object id, UUID string as specified in RFC 4122. If no id
                     is provided, an id will be generated and assigned.
-        :param definition: String describing the definition of the Section.
+        :param definition: String defining this Section.
         :param reference: A reference (e.g. an URL) to an external definition
                           of the Section.
-        :param repository: URL to a repository where this Section can be found.
+        :param repository: URL to a repository in which the Section is defined.
         :param link: Specifies a soft link, i.e. a path within the document.
         :param include: Specifies an arbitrary URL. Can only be used if *link* is not set.
 

odml/section.py

@@ -26,17 +26,17 @@ class BaseSection(base.Sectionable):
     An odML Section.
 
     :param name: string providing the name of the Section. If the name is not
-                 provided, the uuid of the Property is assigned as its name.
+                 provided, the object id of the Section is assigned as its name.
                  Section name is a required attribute.
     :param type: String providing a grouping description for similar Sections.
                  Section type is a required attribute and will be set to the string
                  'n.s.' by default.
     :param parent: the parent object of the new Section. If the object is not
                    an odml.Section or an odml.Document, a ValueError is raised.
-    :param definition: String describing the definition of the Section.
+    :param definition: String defining this Section.
     :param reference: A reference (e.g. an URL) to an external definition
                       of the Section.
-    :param repository: URL to a repository where this Section can be found.
+    :param repository: URL to a repository in which the Section is defined.
     :param link: Specifies a soft link, i.e. a path within the document.
     :param include: Specifies an arbitrary URL. Can only be used if *link* is not set.
     :param oid: object id, UUID string as specified in RFC 4122. If no id is provided,