add anchor link in sub examples (#2171)

russelmrcl · web-flow · commit f2c6b54acbdc · 2025-09-24T13:46:04.000+02:00
* add anchor link in sub examples

* fix broken anchor

* add missing anchor
diff --git a/distribution/examples/README.md b/distribution/examples/README.md
@@ -71,7 +71,7 @@ Samples of scripting with JSONPath, XPath and the expression language you can fi
 
 ## [Legacy Integration for XML and Web Services](web-services-soap#web-services-soap)
 
-### [XML](xml#xml)
+### [XML](xml#xml-examples)
 
 * XML validation and XSLT transformation
 * Create XML plugins with DOM or StAX
@@ -100,7 +100,7 @@ Samples of scripting with JSONPath, XPath and the expression language you can fi
 
 ### [YAML Configuration](yaml-configuration#yaml-configuration)
 
-### [Monitoring and Tracing](monitoring-tracing#monitoring-tracing)
+### [Monitoring and Tracing](monitoring-tracing#monitoring-and-tracing)
 
 * OpenTelemetry & Prometheus
 
diff --git a/distribution/examples/deployment/README.md b/distribution/examples/deployment/README.md
@@ -1 +1,6 @@
-# Deployment and Installation
+# Deployment and Installation
+
+This directory contains examples demonstrating various deployment options and installation methods for the Membrane API Gateway.
+
+- [Membrane Deployment with Docker](docker#membrane-deployment-with-docker)
+- [Membrane Deployment with Windows Service](windows-service#membrane-deployment-with-windows-service)
diff --git a/distribution/examples/deployment/docker/README.md b/distribution/examples/deployment/docker/README.md
diff --git a/distribution/examples/deployment/windows-service/README.md b/distribution/examples/deployment/windows-service/README.md
@@ -0,0 +1 @@
+# Membrane Deployment with Windows Service
diff --git a/distribution/examples/graphql/README.md b/distribution/examples/graphql/README.md
@@ -1 +1,5 @@
-# GraphQL
+# GraphQL
+
+Examples covering GraphQL proxying, schema exposure, and query handling patterns.
+
+- [Validation - GraphQL](graphql-validation#validation---graphql)
diff --git a/distribution/examples/message-transformation/README.md b/distribution/examples/message-transformation/README.md
@@ -1 +1,8 @@
-# Message Transformation
+# Message Transformation
+
+Examples for mapping, enriching, filtering, and format conversion between protocols and payload types.
+
+- [Json2Xml Message Transformation](json2xml#json2xml-message-transformation)
+- [Replace Plugin](replace#replace-plugin)
+- [JSON 2 JSON Message Transformation with JavaScript](transformation-using-javascript#json-2-json-message-transformation-with-javascript)
+- [Xml2json Interceptor](xml2json#xml2json-interceptor)
diff --git a/distribution/examples/monitoring-tracing/README.md b/distribution/examples/monitoring-tracing/README.md
@@ -1 +1,6 @@
-# Monitoring Tracing
+# Monitoring and Tracing
+
+Examples demonstrating metrics, logs, and distributed tracing integration.
+
+- [Tracing with OpenTelemetry](opentelemetry#tracing-with-opentelemetry)
+- [Monitoring with Prometheus and Grafana](prometheus#monitoring-with-prometheus-and-grafana)
diff --git a/distribution/examples/orchestration/README.md b/distribution/examples/orchestration/README.md
@@ -1 +1,8 @@
-# Orchestration
+# Orchestration
+
+Examples showcasing request/response composition, fan‑out/fan‑in, and workflow-style orchestration.
+
+- [Orchestrating Authentication](call-authentication#orchestrating-authentication)
+- [Orchestration: Calling an API with GET](call-get#orchestration:-calling-an-api-with-get)
+- [Using Calls to Modify and POST API Data](call-post#using-calls-to-modify-and-post-api-data)
+- [Orchestration: Aggregating Product Names and Prices](for-loop#orchestration:-aggregating-product-names-and-prices)
diff --git a/distribution/examples/routing-traffic/README.md b/distribution/examples/routing-traffic/README.md
@@ -1 +1,11 @@
-# API Traffic Routing
+# API Traffic Routing
+
+This directory contains examples demonstrating various API traffic routing capabilities of the Membrane API Gateway.
+
+- [Content Based Routing using XPath](content-based-router#content-based-routing-using-xpath)
+- [Dynamic Routing using Target Expressions](dynamic-routing#dynamic-routing-using-target-expressions)
+- [Internal Proxy](internalproxy#internal-proxy)
+- [API Gateway for outgoing Traffic](outgoing-api-gateway#api-gateway-for-outgoing-traffic)
+- [Rewriter](rewriter#rewriter)
+- [Shadowing Interceptor](shadowing#shadowing-interceptor)
+- [Throttle Plugin](throttle#throttle-plugin)
diff --git a/distribution/examples/scripting/README.md b/distribution/examples/scripting/README.md
@@ -1 +1,6 @@
-# Scripting
+# Scripting
+
+Examples that use scripting to implement custom policies and transformations.
+
+- [Access and Manipulate Messages with Groovy Scripts - Example](groovy#access-and-manipulate-messages-with-groovy-scripts---example)
+- [Access and Manipulate Messages with JavaScript - Example](javascript#access-and-manipulate-messages-with-javascript---example)
diff --git a/distribution/examples/validation/README.md b/distribution/examples/validation/README.md
@@ -1 +1,6 @@
-# Message Validation
+# Message Validation
+
+Examples demonstrating schema/contract validation and policy enforcement for incoming/outgoing messages.
+
+- [Validation - Forms](form#validation---forms)
+- [Validation - JSON Schema](json-schema#validation---json-schema)
diff --git a/distribution/examples/web-services-soap/README.md b/distribution/examples/web-services-soap/README.md
@@ -1 +1,12 @@
-# Web Services with SOAP
+# Web Services with SOAP
+
+This section contains examples demonstrating SOAP service integration and mediation patterns.
+
+- [Add a Custom Header to SOAP Messages](add-soap-header#add-a-custom-header-to-soap-messages)
+- [REST 2 SOAP CONVERSION](rest2soap-json#rest-2-soap-conversion)
+- [SOAP to REST Example](rest2soap-template#soap-to-rest-example)
+- [REST 2 SOAP CONVERSION](rest2soap#rest-2-soap-conversion)
+- [Sample SOAP Service: CitiesService](sample-soap-service#sample-soap-service-citiesservice)
+- [Securing a WSDL](secured-wsdl#securing-a-wsdl)
+- [Validation - SOAP](soap-wsdl-validation#validation-soap)
+- [Versioning - SOAP Request and Response Version Transformation](versioning-soap-xslt#versioning---soap-request-and-response-version-transformation)
diff --git a/distribution/examples/websockets/README.md b/distribution/examples/websockets/README.md
@@ -1 +1,8 @@
-# Websockets
+# Websockets
+
+This directory contains examples demonstrating WebSocket functionality with the Membrane API Gateway.
+
+- [CUSTOM WEBSOCKET INTERCEPTORS](custom-websocket-interceptor#custom-websocket-interceptor)
+- [STOMP OVER WEBSOCKET INTERCEPTING](stomp-over-websocket-intercepting#stomp-over-websocket-intercepting)
+- [WEBSOCKET INTERCEPTING EXAMPLE](websocket-intercepting#websocket-intercepting-example)
+- [WEBSOCKET STOMP EXAMPLE](websocket-stomp#websocket-stomp-example)
diff --git a/distribution/examples/xml/README.md b/distribution/examples/xml/README.md
@@ -1 +1,8 @@
-# XML
+# XML Examples
+
+Examples illustrating XML processing, transformation, and routing.
+
+- [Writing XML Processing Plugins](basic-xml-interceptor#writing-xml-processing-plugins)
+- [Custom StAX XML Interceptor Sample](stax-interceptor#custom-stax-xml-interceptor-sample)
+- [Validation - XML](xml-validation#validation---xml)
+- [XSLT INTERCEPTOR](xslt#xslt-interceptor)

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+# Membrane Deployment with Windows Service`