Chapter 5. Features content does not match it's title.
What I am expect for from the the chapters titled 'features' is quick read without a lot of details that covers.
- a list of all the features spring security implements
- if the features is implemented for servlets, reactive or both
- if the feature is turned on by default or not.
- Advice on what features to use for typical scenarios. web app with server side rendering, rest api, web app + rest api in same app, microservice ... etc.
- Links to relevant sections of the docs to learn how to use the features
The chapter as it is toady is not a quick list to read and learn what features spring security implements, it gets into details about why the features exist, how the features are implemented, and how to use the features. Moving the why, how, and what into their own chapters in the introduce part of the docs will improve readability and discoverability of content. Specially I propose that
-
Section 5.1 Authentication become it's own chapter in the introduction part. Content is fine and provides a lot of the background to understand the common aspects of authentication across reactive and servlets.
-
Section5.2 Protection Against Exploits become it's own chapter in the introduction. Content is fine as it is and provides the background on what the features are, why they exist and how to use them.
-
Write new content to become chapter 5 to cover the topics in the bullet points above.
Comment From: rwinch
Good suggestion! Would you be interested in submitting a PR?