Ajust docstrings, following review remarks

Author: lpenet

dataikuapi/dss/dataset.py

@@ -741,15 +741,14 @@ def add_raw_schema_column(self, column):
     def is_feature_group(self):
         """
         Indicates whether the Dataset is defined as a Feature Group, available in the Feature Store.
-        Changes of this property will be applied when calling :meth:`save` and require the "Manage Feature Store" permission.
 
         :rtype: bool
         """
         return self.settings["featureGroup"]
 
     def set_feature_group(self, status):
         """
-        Indicates whether the Dataset is defined as a Feature Group, available in the Feature Store.
+        (Un)sets the dataset as a Feature Group, available in the Feature Store.
         Changes of this property will be applied when calling :meth:`save` and require the "Manage Feature Store" permission.
 
         :param status: whether the dataset should be defined as a feature group

dataikuapi/dss/feature_store.py

@@ -1,14 +1,17 @@
 class DSSFeatureStore(object):
     def __init__(self, client):
         """
-        A handle on the Feature Store. Do not call this methid directly, call """
+        A handle on the Feature Store.
+        Do not create this class directly, use :meth:`DSSClient.get_feature_store`
+        """
         self.client = client
 
     def list_feature_groups(self):
         """
-        Get a list of names of datasets defined as feature groups on the DSS instance.
+        Get a list of names of datasets on which the user has right permissions
+        and that are defined as feature groups in the DSS instance
 
-        :return: list of names of datasets defined as feature groups
+        :return: list of dataset names
         :rtype: list of str
         """
         return self.client._perform_json("GET", "/feature-store/feature-groups/list")

dataikuapi/dssclient.py

@@ -1123,8 +1123,13 @@ def get_object_discussions(self, project_key, object_type, object_id):
     # Feature Store
     ########################################################
     def get_feature_store(self):
-        return DSSFeatureStore(self)
+        """
+        Get a handle to interact with the Feature Store.
 
+        :return: a handle on the feature store
+        :rtype: :class:`dataikuapi.feature_store.DSSFeatureStore`
+        """
+        return DSSFeatureStore(self)
 
 
 class TemporaryImportHandle(object):