[WFLY-11842] Add documentation describing the WildFly Elytron Passwor…

[WFLY-11820] Add detailed documentation for the JDBC SecurityRealm.
Merge pull request #12195 from darranl/WFLY-11820
wildfly
diff --git a/docs/src/main/asciidoc/_elytron/Elytron_Subsystem.adoc b/docs/src/main/asciidoc/_elytron/Elytron_Subsystem.adoc
@@ -232,7 +232,7 @@ filesystem.
 |identity-realm |A security realm definition where identities are
 represented in the management model.
 
-|jdbc-realm |A security realm definition backed by database using JDBC.
+|<<jdbc-security-realm, jdbc-realm>> |A security realm definition backed by database using JDBC.
 
 |key-store-realm |A security realm definition backed by a keystore.
 

diff --git a/docs/src/main/asciidoc/_elytron/General_Elytron_Architecture.adoc b/docs/src/main/asciidoc/_elytron/General_Elytron_Architecture.adoc
@@ -189,3 +189,9 @@ Logon are assigned before even allowing the connection to be fully
 opened, additionally the SecurityIdentity can be established at the time
 the connection is opened and used for any invocations over the
 connection.
+
+:leveloffset: +1
+
+include::Passwords.adoc[]
+
+:leveloffset: -1