add code flow examples to README (#2231)

* add code flow examples to README

* wip

* wip

* wip

* resolve

---------

Co-authored-by: Thomas Bayer <bayer@predic8.de>

Author: russelmrcl

distribution/examples/security/oauth2/README.md

@@ -1,34 +1,33 @@
 # OAuth Examples
 
-## JWT Token Validation against Microsoft's Azure AD
+- [JWT Token Validation (Azure AD)](azure-ad-with-jwts#jwt-token-validation-against-microsofts-azure-ad)
 
-See: [Tutorial](azure-ad-with-jwts/README.md)
+    Validate JWT tokens issued by Microsoft Azure Active Directory.
 
-## Securing APIs with OAuth2 and the Resource Owner Password Flow
+- [OAuth2 Resource Owner Password Flow](api#tutorial-oauth2-resource-owner-password-flow)
 
-See [Tutorial](api/README.md)
+    Secure APIs using username/password-based OAuth2 authentication.
 
-## OAuth2 authorization with OpenID-Connect and OpenID-Discovery using Membrane
+- [OAuth2 Authorization Code Flow](membrane#oauth2-authorization-code-flow-with-membrane-tutorial)
 
-Membrane API Gateway serves as authorization server.
+    Standard OAuth2 flow using authorization codes for web applications.
 
-See [Tutorial](membrane/README.md)
+- [OAuth2 Client Credentials Flow](credentials#oauth2-password-flow-tutorial)
 
-## OAuth2 authorization with OpenID-Connect and OpenID-Discovery using Google
+    Machine-to-machine authentication using client credentials.
 
-Google serves as authorization server.
+- [OAuth2 with OpenID Connect](openid#oauth2-with-openid-connect-and-discovery-tutorial)
+  
+    Use Membrane as an OpenID Connect authorization server.
 
-See [Tutorial](membrane/README.md)
+- [OAuth2 with Google](google#oauth2-with-google-as-authorization-server-tutorial)
+  
+    Authenticate users via Google OAuth2.
 
-## OAuth2 authorization with github as Authorization Server.
+- [OAuth2 with GitHub](github#oauth2-with-github-as-authorization-server-tutorial)
 
-See: [Tutorial](github/README.md)
+    Authenticate users via GitHub OAuth2.
 
-## OAuth2 authorization with google as Authorization Server.
-
-See: [Tutorial](google/README.md)
-
-## OAuth2 implicit Flow
-
-See. [Tutorial](implicit/README.md)
+- [OAuth2 Implicit Flow](implicit#oauth2-implicit-flow-with-javascript-client-tutorial)
 
+    Browser-based authentication example.

distribution/examples/security/oauth2/credentials/README.md

@@ -1,3 +1,5 @@
-This example shows the OAuth2 password flow. A client requests an access token, and the token is verified through a token validator.
+# OAuth2 Password Flow Tutorial
+
+A client requests an access token that will be verified through a token validator.
 
 See [OAuth2 Client Credentials Flow (API Access)](https://www.membrane-api.io/tutorials/oauth2/oauth2-credentials-flow.html)

distribution/examples/security/oauth2/github/README.md

@@ -1,3 +1,3 @@
-This example shows OAuth2 authorization with the help of GitHub as an authorization server.
+# OAuth2 with GitHub as Authorization Server Tutorial
 
 See [OAuth2 with GitHub (Login Integration)](https://www.membrane-api.io/tutorials/oauth2/oauth2-github.html)

distribution/examples/security/oauth2/google/README.md

@@ -1,3 +1,3 @@
-This example shows OAuth2 authorization with help of Google as an authorization server.
+# OAuth2 with Google as Authorization Server Tutorial
 
 See [OAuth2 with Google (Web App Login)](https://www.membrane-api.io/tutorials/oauth2/oauth2-google.html)

distribution/examples/security/oauth2/implicit/README.md

@@ -1,3 +1,3 @@
-This example shows the OAuth2 implicit flow. It uses a JavaScript client.
+# OAuth2 Implicit Flow with JavaScript Client Tutorial
 
 See [OAuth2 Implicit Flow (Browser Clients)](https://www.membrane-api.io/tutorials/oauth2/oauth2-implicit-flow-example.html)

distribution/examples/security/oauth2/membrane/README.md

@@ -1,3 +1,5 @@
-This example shows OAuth2 authorization with OpenID-Connect and OpenID-Discovery. It uses Membrane as an authorization server.
+# OAuth2 Authorization Code Flow with Membrane Tutorial
+
+Example showing how to use Membrane API Gateway as OAuth2 Authorization and resource server.
 
 See [OAuth2 Authorization Code Flow (Membrane)](https://www.membrane-api.io/tutorials/oauth2/oauth2-code-flow-example.html)

distribution/examples/security/oauth2/openid/README.md

@@ -1,3 +1,5 @@
-This example shows OAuth2 authorization with OpenID-Connect and OpenID-Discovery. It uses Google as an authorization server.
+# OAuth2 with OpenID Connect and Discovery Tutorial
+
+Membrane connects to Google as an external OpenID provider.
 
 See [OAuth2 / OpenID Connect (External Providers)](https://www.membrane-api.io/tutorials/oauth2/oauth2-openid.html)