Update layout of client guide based on feedback (smithy-lang#2533)

Author: hpmellema

docs/source-2.0/languages/java/client/dynamic-client.rst

@@ -48,9 +48,6 @@ Now, create the ``DynamicClient`` instance for this model and service:
     var client = DynamicClient.builder()
         .service(shapeId)
         .model(model)
-        .protocol(new RestJsonClientProtocol(shapeId))
-        .transport(new JavaHttpClientTransport())
-        .endpointResolver(EndpointResolver.staticEndpoint("https://api.cafe.example.com"))
         .build();
 
 .. admonition:: Important
@@ -67,3 +64,17 @@ The ``Document.createFromObject`` method can create a ``Document`` from a map:
     var input = Document.createFromObject(Map.of("coffeeType", "COLD_BREW"));
     var result = client.call("CreateOrder", input).get();
     System.out.println(result);
+
+Dynamic clients, like generated clients, support the runtime configuration of protocols,
+transports, auth schemes, and endpoint resolvers:
+
+.. code-block:: java
+
+    var client = DynamicClient.builder()
+        .service(shapeId)
+        .model(model)
+        .protocol(new RestJsonClientProtocol(shapeId))
+        .transport(new JavaHttpClientTransport())
+        .addPlugin(new MyPlugin())
+        .endpointResolver(EndpointResolver.staticEndpoint("https://api.cafe.example.com"))
+        .build();

docs/source-2.0/languages/java/client/index.rst

@@ -17,9 +17,8 @@ For a general introduction the the Smithy Java framework, see the Smithy :doc:`.
     :maxdepth: 1
 
     generating-clients
-    codegen-integrations
-    dynamic-client
     configuration
     customization
     plugins
-
+    dynamic-client
+    codegen-integrations

docs/source-2.0/languages/java/client/plugins.rst

@@ -71,7 +71,7 @@ The added agent header has the form:
 
 .. code-block::
 
-    smithy-java/<smithy> ua/<ua> os/<family>#<version> lang/java#<version> m/<features>
+    smithy-java/<smithy> ua/<ua> os/<os-family>#<os-version> lang/java#<java-version> m/<features>
 
 .. list-table::
     :header-rows: 1
@@ -89,9 +89,12 @@ The added agent header has the form:
     * - ``os-family``
       - ``macos``
       - Operating system client is running on
-    * - ``version``
+    * - ``os-version``
       - ``14.6.1``
-      - version of OS or Language the client is running on.
+      - version of OS client is running on.
+    * - ``java-version``
+      - ``17.2.0``
+      - version of Java client is running on.
     * - ``features``
       - ``a,b``
       - Comma-separated list of feature Ids