diff --git a/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/Analyzer.java b/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/Analyzer.java
index 70d9139e0..ab5f38c85 100644
--- a/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/Analyzer.java
+++ b/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/Analyzer.java
@@ -237,7 +237,9 @@ public String name() {
   /**
    * Gets the stopwords.
    *
-   * Custom stopwords to use with the named analyzer.
+   * Custom stopwords to use with the named analyzer where supported. Not used for `keyword`, `simple`, `whitespace`,
+   * `simple_asciifolding` or `perfield` analyzers. Ensure stopwords match the folded case for analyzers that perform
+   * folding.
    *
    * @return the stopwords
    */
diff --git a/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/AnalyzerConfiguration.java b/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/AnalyzerConfiguration.java
index c5f2eb275..c5f483ba7 100644
--- a/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/AnalyzerConfiguration.java
+++ b/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/AnalyzerConfiguration.java
@@ -271,7 +271,9 @@ public String name() {
   /**
    * Gets the stopwords.
    *
-   * Custom stopwords to use with the named analyzer.
+   * Custom stopwords to use with the named analyzer where supported. Not used for `keyword`, `simple`, `whitespace`,
+   * `simple_asciifolding` or `perfield` analyzers. Ensure stopwords match the folded case for analyzers that perform
+   * folding.
    *
    * @return the stopwords
    */
diff --git a/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/DesignDocument.java b/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/DesignDocument.java
index 081ec39c1..37700bb93 100644
--- a/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/DesignDocument.java
+++ b/modules/cloudant/src/main/java/com/ibm/cloud/cloudant/v1/model/DesignDocument.java
@@ -735,8 +735,8 @@ public void setOptions(final DesignDocumentOptions options) {
    * The validation function can abort the pending document write by throwing one of two error objects:
    *
    * ```
-   * // user is not authorized to make the change but may re-authenticate throw({ unauthorized: 'Error message here.'
-   * });
+   * // user is not authorized to make the change but may
+   * // re-authenticate throw({ unauthorized: 'Error message here.' });
    *
    * // change is not allowed throw({ forbidden: 'Error message here.' });
    * ```