docs(generated): known issues updates

Generated SDK source code using: - Generator version 3.79.0 - Specification version 1.0.0-dev0.0.52 - Automation (cloudant-sdks) version 59ef3e0 Signed-off-by: cloudant-sdks-automation <[email protected]>
IBM · Sep 19, 2023 · 2959d47 · 2959d47
1 parent 9ea699b
commit 2959d47
Showing 1 changed file with 13 additions and 1 deletion.
diff --git a/KNOWN_ISSUES.md b/KNOWN_ISSUES.md
@@ -99,7 +99,8 @@ As such the issue will only manifest when trying to read a design document creat
 
 #### Facet counting deserialization errors in no match cases
 
-When obtaining a `SearchResult` with `counts` if there are no matches a deserialization error is encountered:
+In Apache CouchDB versions `3.3.2` or older and Cloudant versions `j8435` and older
+when obtaining a `SearchResult` with `counts` if there are no matches a deserialization error is encountered:
 ```
 java.lang.IllegalStateException: Expected BEGIN_OBJECT but was NUMBER
 ```
@@ -178,3 +179,14 @@ As such the issue will only manifest when trying to read a replication document
   ```
 
 If you need to read a replication document that uses string format source or target URLs the workaround is to use the `getDocumentAsStream` [Raw IO](/#raw-io) function with the `_replicator` database name and your replication document id to custom deserialize the response.
+
+### Queries
+
+#### Explain response
+
+With Apache CouchDB versions `3.3.2` or older and Cloudant versions `j8442` and older
+deserialization of the `_explain` response fails when the request does not
+list any `fields` to project and hence the response includes `"fields": "all_fields"`.
+
+If it is not possible to use a newer server version the workaround is to use
+[Raw IO](/#raw-io) functions to custom deserialize the response.