Improve docstrings of build/create classmethods

factory/base.py

@@ -507,13 +507,18 @@ def _create(cls, model_class, *args, **kwargs):
 
     @classmethod
     def build(cls, **kwargs):
-        """Build an instance of the associated class, with overridden attrs."""
+        """Build an instance of the associated class, with overridden attrs.
+        
+        The instance will not be saved and persisted to any datastore.
+        """
         return cls._generate(enums.BUILD_STRATEGY, kwargs)
 
     @classmethod
     def build_batch(cls, size, **kwargs):
         """Build a batch of instances of the given class, with overridden attrs.
 
+        The instances will not be saved and persisted to any datastore.
+
         Args:
             size (int): the number of instances to build
 
@@ -524,13 +529,18 @@ def build_batch(cls, size, **kwargs):
 
     @classmethod
     def create(cls, **kwargs):
-        """Create an instance of the associated class, with overridden attrs."""
+        """Create an instance of the associated class, with overridden attrs.
+
+        The instance will be saved and persisted in the appropriate datastore.
+        """
         return cls._generate(enums.CREATE_STRATEGY, kwargs)
 
     @classmethod
     def create_batch(cls, size, **kwargs):
         """Create a batch of instances of the given class, with overridden attrs.
 
+        The instances will be saved and persisted in the appropriate datastore.
+
         Args:
             size (int): the number of instances to create