GitHub-Spring
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Browse Source

What's new and migrating are prominently featured 

Before this commit those were burried in the Appendix where few would
guess to look. Previously that information was at the top, so it makes
sense to point to the Github wiki from the index HTML page.

Also a general update of the index page. Since we have recently revised
the overview, we can simply point to it and keep it shorter.

The section listing now includes more details per section.
pull/1540/merge
Rossen Stoyanchev 8 years ago
parent
6597551858
commit
45c207aece
3 changed files with 30 additions and 45 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 12
      src/docs/asciidoc/appendix.adoc
  2. 57
      src/docs/asciidoc/index.adoc
  3. 6
      src/docs/asciidoc/overview.adoc

12
src/docs/asciidoc/appendix.adoc
Unescape View File

@ -7,18 +7,6 @@
:toclevels: 2 :toclevels: 2
:docinfo1: :docinfo1:
[[spring-whats-new]]
== What's New in the Spring Framework
"What's New" guides for releases of the Spring Framework are now provided as a
link:{wiki-spring-framework}/++What's-New-in-the-Spring-Framework++[Wiki page].
[[migration-4.x]]
== Migrating to Spring Framework 4.3 / 5.0
Migration guides for upgrading from previous releases of the Spring Framework are now provided as a
{wiki-spring-framework}/Migrating-from-earlier-versions-of-the-spring-framework[Wiki page].
[[annotation-programming-model]] [[annotation-programming-model]]
== Spring Annotation Programming Model == Spring Annotation Programming Model
Spring's annotation programming model is documented in the Spring's annotation programming model is documented in the

57
src/docs/asciidoc/index.adoc
Unescape View File

@ -3,36 +3,27 @@ The Spring Framework team and contributors https://github.com/spring-projects/sp
:doc-root: https://docs.spring.io :doc-root: https://docs.spring.io
:api-spring-framework: {doc-root}/spring-framework/docs/{spring-version}/javadoc-api/org/springframework :api-spring-framework: {doc-root}/spring-framework/docs/{spring-version}/javadoc-api/org/springframework
Welcome to the Spring Framework reference!
The Spring Framework is a lightweight solution and a potential one-stop-shop for
building your enterprise-ready applications. However, Spring is modular, allowing you to Please read the <<overview.adoc,Overview>> for an introduction including brief history,
use only those parts that you need, without having to bring in the rest. You can use the design philosophy, where to ask questions, and tips to get started. For information on
IoC container, with any web framework on top, but you can also use only the what's new, or migrating from a previous version, check the
<<data-access.adoc#orm-hibernate,Hibernate integration code>> or the https://github.com/spring-projects/spring-framework/wiki[Github Wiki].
<<data-access.adoc#jdbc-introduction,JDBC abstraction layer>>. The Spring Framework supports declarative
transaction management, remote access to your logic through RMI or web services, and various The reference is divided into several sections:
options for persisting your data.
It offers full-featured web frameworks such as <<web.adoc#mvc,Spring Web MVC>> [horizontal]
and <<web-reactive.adoc#webflux, Spring WebFlux>>; and it enables you to <<core.adoc#spring-core,Core>> :: IoC container, Events, Resources, i18n, Validation,
integrate <<core.adoc#aop-introduction,AOP>> transparently into your software. Data Binding, Type Conversion, SpEL, AOP.
<<testing.adoc#testing,Testing>> :: Mock objects, TestContext framework,
This document is a reference guide to Spring Framework features. Questions on the Spring MVC Test, WebTestClient.
Framework itself should be asked on StackOverflow (see https://spring.io/questions[]). <<data-access.adoc#spring-data-tier,Data Access>> :: Transactions, DAO support, JDBC,
ORM, Marshalling XML.
This reference document provides the following sections: <<web.adoc#spring-web,Web Servlet>> :: Spring MVC web framework, WebSocket,
SockJS, STOMP messaging.
* <<overview.adoc#spring-introduction,Overview of the Spring Framework>> <<web-reactive.adoc#spring-webflux,Web Reactive>> :: Spring WebFlux,
WebClient, WebSocket support.
* <<core.adoc#spring-core,Core concepts such as IoC and AOP>> <<integration.adoc#spring-integration,Integration>> :: Remoting, JMS, JCA, JMX, Email,
Tasks, Scheduling, Cache, Dynamic languages.
* <<testing.adoc#testing,Testing with Spring>> <<kotlin.adoc#kotlin,Kotlin>> :: Extensions, Bean Definition DSL, WebFlux DSL
<<appendix.adoc#spring-appendices,Appendix>> :: XML Schemas, JSP Tag Libraries
* <<data-access.adoc#spring-data-tier,Data access and transaction management>>
* The Web on <<web.adoc#spring-web,Servlet>> or <<web-reactive.adoc#spring-webflux,Reactive>> stacks
* <<kotlin.adoc#kotlin,Kotlin support>>
* <<integration.adoc#spring-integration,Integration with other technologies>>
* <<appendix.adoc#spring-appendices,Appendix>>

6
src/docs/asciidoc/overview.adoc
Unescape View File

@ -1,6 +1,7 @@
:toc: left :toc: left
:toclevels: 1 :toclevels: 1
:docinfo1: :docinfo1:
= Spring Framework Overview = Spring Framework Overview
Spring makes it easy to create Java enterprise applications. It provides everything you Spring makes it easy to create Java enterprise applications. It provides everything you
@ -19,6 +20,7 @@ Spring is open source. It has a large and active community that provides continu
based on a diverse range of real-world use cases. This has helped Spring to successfully based on a diverse range of real-world use cases. This has helped Spring to successfully
evolve over a very long time. evolve over a very long time.
[[overview-spring]]
== What We Mean by "Spring" == What We Mean by "Spring"
The term "Spring" means different things in different contexts. It can be used to refer to The term "Spring" means different things in different contexts. It can be used to refer to
@ -41,6 +43,7 @@ A note about modules: Spring's framework jars allow for deployment to JDK 9's mo
the same naming pattern with "-" instead of ".", e.g. "spring-core" and "spring-context"). the same naming pattern with "-" instead of ".", e.g. "spring-core" and "spring-context").
Of course, Spring's framework jars keep working fine on the classpath on both JDK 8 and 9. Of course, Spring's framework jars keep working fine on the classpath on both JDK 8 and 9.
[[overview-history]]
== History of Spring and the Spring Framework == History of Spring and the Spring Framework
Spring came into being in 2003 as a response to the complexity of the early Spring came into being in 2003 as a response to the complexity of the early
@ -81,6 +84,7 @@ among others. It’s important to remember that each project has its own source
issue tracker, and release cadence. See https://spring.io/projects[spring.io/projects] for issue tracker, and release cadence. See https://spring.io/projects[spring.io/projects] for
the complete list of Spring projects. the complete list of Spring projects.
[[overview-philosophy]]
== Design Philosophy == Design Philosophy
When you learn about a framework, it’s important to know not only what it does but what When you learn about a framework, it’s important to know not only what it does but what
@ -103,6 +107,7 @@ that are intuitive and that hold up across many versions and many years.
meaningful, current, and accurate Javadoc. It is one of very few projects that can claim meaningful, current, and accurate Javadoc. It is one of very few projects that can claim
clean code structure with no circular dependencies between packages. clean code structure with no circular dependencies between packages.
[[overview-feedback]]
== Feedback and Contributions == Feedback and Contributions
For how-to questions or diagnosing or debugging issues, we suggest using StackOverflow, For how-to questions or diagnosing or debugging issues, we suggest using StackOverflow,
@ -122,6 +127,7 @@ information that is not specific to any one version. For example, it has migrati
notes from earlier versions, comprehensive information on what's new across multiple notes from earlier versions, comprehensive information on what's new across multiple
versions, contributor guidelines, the Spring Framework code style, and other information. versions, contributor guidelines, the Spring Framework code style, and other information.
[[overview-getting-started]]
== Getting Started == Getting Started
If you are just getting started with Spring, you may want to begin using the Spring If you are just getting started with Spring, you may want to begin using the Spring

Write Preview
Loading…
Cancel
Save