diff --git a/soap/README.md b/soap/README.md
index c6e804b9..6bcb5ce2 100644
--- a/soap/README.md
+++ b/soap/README.md
@@ -47,4 +47,11 @@ api = Feign.builder()
      .decoder(new SOAPDecoder(jaxbFactory))
      .errorDecoder(new SOAPErrorDecoder())
      .target(MyApi.class, "http://api");
-```
\ No newline at end of file
+```
+
+In certain situations the declarations on the SOAP envelope are not inherited by JAXB when reading the documents.  This is particularly
+troublesome when it is not possible to correct the XML at the source.
+
+To account for this situation, use the `useFirstChild` option on the `SOAPDecoder` builder.  This will instruct JAX be to use `SOAPBody#getFirstChild()`
+instead of `SOAPBody#extractContentAsDocument()`.  This will allow users to supply a `package-info.java` to manage the element namespaces
+explicitly and define what should occur if the namespace declarations are missing.
\ No newline at end of file