improve guide layout

Author: EronHennessey

doc_source/advanced.rst

@@ -8,9 +8,9 @@
    either express or implied. See the License for the specific language governing permissions and
    limitations under the License.
 
-#################
-|sdk-java| Basics
-#################
+#############
+Using the SDK
+#############
 
 This section provides important general information about programming with the |sdk-java|.
 Information in this section applies to all services that you might be using with the |sdk-java|.
@@ -27,3 +27,7 @@ For information that is specific to a particular service (EC2, SWF, etc.), see t
    java-dg-exceptions
    basics-async
    java-dg-logging
+   section-client-configuration
+   java-dg-access-control
+   java-dg-jvm-ttl
+

doc_source/basics.rst

@@ -16,9 +16,13 @@ This topic describes important changes to the |sdk-java-dg| over the course of i
 
 **Last documentation update:** |today|
 
+Sep 26, 2016
+    The topics in the **Advanced** section have been moved into :doc:`basics`, since they really are
+    central to using the SDK.
+
 Aug 25, 2016
-    A new topic, :doc:`creating-clients`, has been added to the :doc:`basics` section, which
-    demonstrates how to use *client builders* to simplify the creation of AWS service clients.
+    A new topic, :doc:`creating-clients`, has been added to :doc:`basics`, which demonstrates how to
+    use *client builders* to simplify the creation of AWS service clients.
 
     The :doc:`prog-services` section has been updated with :doc:`new examples for S3 <examples/s3>`
     which are backed by a `repository on GitHub <sdk-doc-examples_>`_ that contains the complete
@@ -56,8 +60,8 @@ Feb 23, 2016
     <awsdocs/aws-java-developer-guide>`.
 
 Dec 28, 2015
-    :doc:`java-dg-jvm-ttl` has been moved from :doc:`advanced` into the :doc:`basics` section, and
-    has been rewritten for clarity.
+    :doc:`java-dg-jvm-ttl` has been moved from **Advanced** into :doc:`basics`, and has been
+    rewritten for clarity.
 
     :doc:`setup-project-maven` has been updated with information about how to include the
     SDK's bill of materials (BOM) in your project.

doc_source/document-history.rst

@@ -24,7 +24,6 @@
    getting-started
    basics
    prog-services
-   advanced
    document-history
 
 .. include:: about-aws.txt

doc_source/index.rst

@@ -8,11 +8,11 @@
    either express or implied. See the License for the specific language governing permissions and
    limitations under the License.
 
-######################
-Tutorials and Examples
-######################
+####################
+Programming Examples
+####################
 
-This section provides tutorials and examples of using the |sdk-java| with AWS service clients.
+This section provides tutorials and examples of using the |sdk-java| to program AWS services.
 
 .. tip:: See :ref:`additional-resources` for more examples and additional resources available for
    |sdk-java| developers!