Introduce mocked-up macro syntax with the goal of eliminating
duplication of common sections, introductions, disclaimers, etc.
See gs-macros.md[1] for expanded values.
[1]: https://github.com/springframework-meta/springframework.org/tree/master/doc/gs-macros.md
- Standardize capitalization across title and subsection headers
- Standardize grammar of title and subsection headers
- Standardize link format
Also now wrap Maven/Gradle sections in <span> tags with 'maven' and
'gradle' class values to allow us to apply CSS to these to hide or show
based on value of Maven / Gradle toggle control in UI. Ideally this
should be a <div>, but by default Markdown syntax is not supported (i.e.
parsed) within divs. See
http://daringfireball.net/projects/markdown/syntax#html for details.
Fixed some small issues that made the 'start' version not runnable at the end.
The 'start' version has missing bits in the pom.xml as well as differences in what
the guide said. After comparing with 'complete', made the fixes and updated the
guide appropriately so it should work top-to-bottom if you use 'start' and really
copy-n-paste your way along.
Ensure the user can execute a `mvn package` after every step, i.e. that
there is never a moment in which the user sees a compilation error in
the IDE or at the command line.