Merge pull request spring-projects#1 from btalbott/master

Edit README and SIDEBAR, add comments to commit

Author: gregturn

README.ftl.md

@@ -3,16 +3,15 @@
 What you'll build
 -----------------
 
-This guide provides an introduction to [Spring Boot][spring-boot] by building a simple web application. This doesn't demonstrate all of its features but will help you get started with the concepts Spring Boot has to offer.
+This guide walks you through the process of building a simple web application with [Spring Boot][spring-boot]. The guide provides a sampling of how Spring Boot helps you accelerate and facilitate app development. As you read more Spring getting started guides, you will see more use cases for Spring Boot.
 
 What you'll need
 ----------------
 
  - About 15 minutes
  - <@prereq_editor_jdk_buildtools/>
 
-
-## <@how_to_complete_this_guide jump_ahead="Warming up with Spring Boot"/>
+## <@how_to_complete_this_guide jump_ahead='Learn what you can do with Spring Boot'/>
 
 
 <a name="scratch"></a>
@@ -27,41 +26,45 @@ Set up the project
 
     <@snippet path="pom.xml" prefix="initial"/>
 
-Warming up with Spring Boot
----------------------------
+Learn what you can do with Spring Boot
+--------------------------------------
 
-What does Spring Boot provide? At the core, it offers a much faster way to build applications because it make reasonable assumptions such as looking at your classpath and other beans you have configured to see what you're missing.
+Spring Boot offers a fast way to build applications. It looks at your classpath and at beans you have configured, makes reasonable assumptions about what you're missing, and adds it. With Spring Boot you can focus more on business features and less on infrastructure.
 
 For example:
-- Got Spring MVC? There are a handful of needed beans people almost always use in that situation. Spring Boot adds them automatically. But why stop there? A Spring MVC app needs a servlet container so Spring Boot automatically configures embedded Tomcat.
-- Got Jetty? You probably do NOT want Tomcat, but instead embedded Jetty. Don't lift a finger; Spring Boot handles it for you.
-- Got Thymeleaf? There are a few beans that must always be added to your application context. Why should you have to deal with that? Let Spring Boot handle it for you.
-- Doing multipart file uploads? The [MultipartConfigElement](http://docs.oracle.com/javaee/6/api/javax/servlet/MultipartConfigElement.html) is part of the servlet 3.0 spec and let's you define upload parameters in pure Java. Why should you have to worry about plugging that into your servlet? Define one in your application context and Spring Boot will snatch it up and plug it into Spring MVC's battle tested `DispatcherServlet`.
+- Got Spring MVC? There are several specific beans you almost always need, and Spring Boot adds them automatically. A Spring MVC app also needs a servlet container, so Spring Boot automatically configures embedded Tomcat.
+- Got Jetty? If so, you probably do NOT want Tomcat, but instead embedded Jetty. Spring Boot handles that for you.
+- Got Thymeleaf? There are a few beans that must always be added to your application context; Spring Boot adds them for you.
+- Doing multipart file uploads? [MultipartConfigElement](http://docs.oracle.com/javaee/6/api/javax/servlet/MultipartConfigElement.html) is part of the servlet 3.0 spec and lets you define upload parameters in pure Java. With Spring Boot, you don't have to plug that into your servlet. Define one in your application context and Spring Boot will plug it into Spring MVC's battle-tested `DispatcherServlet`.
 
-It doesn't stop there. These are just a few examples of the automatic configuration provided by Spring Boot. But it doesn't get in your way. For example, Spring Boot may make assumptions and add a `SpringTemplateEngine` for your Thymeleaf-based application, unless you've already defined one. At that point, Spring Boot automatically steps aside and lets you take control.
+These are just a few examples of the automatic configuration Spring Boot provides. At the same time, Spring Boot doesn't get in your way. For example, Spring Boot may make assumptions and add a `SpringTemplateEngine` for your Thymeleaf-based application, unless you've already defined one. At that point, Spring Boot automatically steps aside and lets you take control.
 
-Creating a simple web application
+Create a simple web application
 ---------------------------------
-You already have the base build file at the top. Next step is to create a web controller for a simple web application.
+You already have the base build file at the top. Now you can create a web controller for a simple web application.
 
     <@snippet path="src/main/java/hello/HelloController.java" prefix="initial"/>
 
-The class is flagged as a `@Controller` meaning it's ready for use by Spring MVC to handle web requests. `@RequestMapping` maps `/` to the `index()` method. When invoked from a browser or using curl on the command line, it returns pure text thanks to the `@ResponseBody` annotation.
+The class is flagged as a `@Controller`, meaning it's ready for use by Spring MVC to handle web requests. `@RequestMapping` maps `/` to the `index()` method. When invoked from a browser or using curl on the command line, the method returns pure text thanks to the `@ResponseBody` annotation.
 
-To make it executable, create an `Application` class:
+Create an Application class
+---------------------------
+Here you create an `Application` class with the components:
 
     <@snippet path="src/main/java/hello/Application.java" prefix="initial"/>
 
 - `@Configuration` tags the class as a source of bean definitions for the application context.
-- `@EnableAutoConfiguration` tells Spring Boot to get going and start adding beans based on classpath settings, other beans, and various property settings.
+- `@EnableAutoConfiguration` tells Spring Boot to start adding beans based on classpath settings, other beans, and various property settings.
 - `@EnableWebMvc` signals Spring MVC that this application is a web application and to activate key behaviors such as setting up a `DispatcherServlet`.
 - `@ComponentScanning` tells Spring to look for other components, configurations, and services in the the `hello` package, allowing it to find the `HelloController`.
 
 The `main()` method uses Spring Boot's `SpringApplication.run()` method to launch an application. Did you notice that there wasn't a single line of XML? No **web.xml** file either. This web application is 100% pure Java and you didn't have to deal with configuring any plumbing or infrastructure.
 
 The `run()` method returns an `ApplicationContext` and this application then retrieves all the beans that were created either by your app or were automatically added thanks to Spring Boot. It sorts them and prints them out.
 
-To run it, execute:
+Run the application
+-------------------
+To run the application, execute:
 
 ```sh
 $ mvn package spring-boot:run
@@ -116,9 +119,9 @@ $ curl localhost:8080
 Greetings from Spring Boot!
 ```
 
-Switching to Jetty
-------------------
-What if you preferred Jetty over Tomcat? They're both compliant servlet containers, so it should be darn simple to switch. And it is!
+Switch from Tomcat to Jetty
+---------------------------
+Jetty and Tomcat are both compliant servlet containers, so it's easy to switch.
 
 Add this to your build file's list of dependencies:
 
@@ -129,24 +132,24 @@ Add this to your build file's list of dependencies:
         </dependency>
 ```
 
-Adding multipart upload support
+Add multipart upload support
 -------------------------------
-Imagine you also want to add file upload support. To do that, update your configuration and add a `MultipartConfigElement` to the application context.
+Suppose you want to add file upload support. To do that, update your configuration and add a `MultipartConfigElement` to the application context.
 
     <@snippet path="src/main/java/hello/Application.java" prefix="complete"/>
     
-> **Note:** A production version of `MultipartConfigElement` would not be empty but instead specify things like target upload path, file size upload limits, etc.
+> **Note:** A production version of `MultipartConfigElement` would not be empty; it would specify target upload path, file size upload limits, and so forth.
 
-Re-run the app
---------------
+Re-run the application
+----------------------
 
 Run the app again:
 
 ```sh
 $ mvn package spring-boot:run
 ```
 
-Now check out the output:
+Now check the output:
 
 ```sh
 Let's inspect the beans provided by Spring Boot:
@@ -189,15 +192,15 @@ simpleControllerHandlerAdapter
 viewControllerHandlerMapping
 ```
 
-There is little change from the previous output, except there is no longer a `tomcatEmbeddedServletContainerFactory`. Instead, there is a new `jettyEmbeddedServletContainer`. 
+Little changes from the previous output, except there is no longer a `tomcatEmbeddedServletContainerFactory`. Instead, there is a new `jettyEmbeddedServletContainer`. 
 
 There is also the `multipartConfigElement` you added. But along with it came a `multipartResolver` [courtesy of Spring Boot](https://github.com/SpringSource/spring-boot/blob/master/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/web/MultipartAutoConfiguration.java), a bean recommended to support file uploads with Spring MVC.
 
-Other than that, everything else appears the same, as it should be. Most the beans listed above provide Spring MVC's production-grade features. Just swapping one part, the servlet container, and adding upload support shouldn't cause a system wide ripple.
+Otherwise, everything is the same, as it should be. Most beans listed above provide Spring MVC's production-grade features. Simply swapping one part, the servlet container, and adding upload support shouldn't cause a system-wide ripple.
 
-Adding consumer-grade services
+Add consumer-grade services
 ------------------------------
-If you are building a web site for your business, there are probably some management services you are thinking about adding. Spring Boot provides several out of the box with its [actuator module][spring-boot-actuator] like health, audits, beans, and more.
+If you are building a web site for your business, you probably need to add some management services. Spring Boot provides several out of the box with its [actuator module][spring-boot-actuator], such as health, audits, beans, and more.
 
 Add this to your pom.xml:
 ```xml
@@ -243,14 +246,14 @@ You can invoke shutdown through curl.
 $ curl -X POST localhost:8080/shutdown
 ```
 
-The response shows that shutdown through REST is currently disabled by default (thank goodness!):
+The response shows that shutdown through REST is currently disabled by default:
 ```sh
 {"message":"Shutdown not enabled, sorry."}
 ```
 
-For more details about each of these REST points and how you can tune their settings with an ``application.properties` file, feel free to dig into the [Spring Boot][spring-boot] project.
+For more details about each of these REST points and how you can tune their settings with an ``application.properties` file, check out the [Spring Boot][spring-boot] project.
 
-Spring Boot's starters
+View Spring Boot's starters
 ----------------------
 You have seen some of Spring Boot's **starters**. Here is a complete list:
 - spring-boot-starter-actuator
@@ -265,9 +268,9 @@ You have seen some of Spring Boot's **starters**. Here is a complete list:
 - spring-boot-starter-web
 
 
-That is not all
----------------
-That last example showed how Spring Boot makes it easy to wire beans you may not be aware you need. And it showed how to turn on convenient management services.
+JAR support and Groovy support
+------------------------------
+The last example showed how Spring Boot makes it easy to wire beans you may not be aware that you need. And it showed how to turn on convenient management services.
 
 But Spring Boot does yet more. It supports not only traditional WAR file deployments, but also makes it easy to put together executable JARs thanks to Spring Boot's loader module. The various guides demonstrate this dual support through the `spring-boot-maven-plugin`. 
 
@@ -290,7 +293,7 @@ class ThisWillActuallyRun {
 
 Next, [install Spring Boot's CLI](https://github.com/SpringSource/spring-boot#installing-the-cli).
 
-Finally, run it as follows:
+Run it as follows:
 
 ```sh
 $ spring run app.groovy
@@ -300,11 +303,9 @@ Hello World!
 
 Spring Boot dynamically adds key annotations to your code and leverages [Groovy Grapes](http://groovy.codehaus.org/Grape) to pull down needed libraries to make the app run.
 
-Congratulations!
+Summary
 ----------------
-Spring Boot is powerful, but frankly too big to fit into a single guide. This is just a sampling of how much it can ramp up your development pace, letting you focus on business features and not worry about infrastructure.
-
-As you read more of this site's getting started guides, you will see it used all over the place. It might not be obvious at first, because Spring Boot is so good at adding the things you need without getting in your way. But after using it for a bit, you may wonder how you lived without it.
+Congratulations! You built a simple web application with Spring Boot and learned how it can ramp up your development pace. 
 
 [spring-boot]: https://github.com/SpringSource/spring-boot
 [spring-boot-actuator]: https://github.com/SpringSource/spring-boot/blob/master/spring-boot-actuator/README.md

SIDEBAR.md

@@ -1,32 +1,32 @@
-## Related Resources
+## Related resources
 
-Spring Boot provides a wide range of support for various services. It's used for most of these guides. This list contains some of them, showing its diverse support.
+Spring Boot provides a wide range of support for various services, including most services doumented in the Spring Getting Started guides. Some of these guides are listed here.
 
-### Getting Started Guides
+### Getting Started guides
 
 * [Building a RESTful Web Service with Spring Boot Actuator][gs-actuator-service]
 * [Accessing Data with JPA][gs-accessing-data-jpa]
 * [Creating Asynchronous Methods][gs-async-method]
 * [Creating a Batch Service][gs-batch-processing]
 * [Securing a Web Application][gs-securing-web]
 * [Uploading a File][gs-uploading-files]
-* [Converting a Spring Boot JAR-based application into a WAR][gs-convert-jar-to-war]
+* [Converting a Spring Boot JAR-based application to a WAR][gs-convert-jar-to-war]
 
 [gs-actuator-service]: /guides/gs/actuator-service/content
 [gs-accessing-data-jpa]: /guides/gs/accessing-data-jpa/content
-[gs-async-method]: /guides/gs/async-methd/content
+[gs-async-method]: /guides/gs/async-method/content
 [gs-batch-processing]: /guides/gs/batch-processing/content
 [gs-securing-web]: /guides/gs/securing-web/content
 [gs-uploading-files]: /guides/gs/uploading-files/content
-[gs-convert-jar-to-war]: /guides/gs/converting-jar-to-war/content
+[gs-convert-jar-to-war]: /guides/gs/convert-jar-to-war/content
 
 ### Tutorials
 
 * [Tutorial TBD][tut-tbd]
 
 [tut-tbd]: /guides/tutorials/tbd
 
-### Concepts and Technologies
+### Concepts and technologies
 
 * [REST][u-rest]
 * [JSON][u-json]