add mesh gateway docs (#3171)

Author: mfordjody

assets/scss/_custom.scss

@@ -986,8 +986,8 @@ body.td-documentation .td-main > .row > main .td-content .card {
 
 .td-content {
   p {
-    font-size: 16px;
-    line-height: 1.7;
+    font-size: 15px;
+    line-height: 1.2;
     margin-bottom: 1.25rem;
   }
 
@@ -1021,14 +1021,14 @@ body.td-documentation .td-main > .row > main .td-content .card {
   }
 
   ul, ol {
-    font-size: 16px;
-    line-height: 1.7;
+    font-size: 14px;
+    line-height: 1.0;
     margin-bottom: 1.25rem;
     padding-left: 2rem;
 
     li {
       margin-bottom: 0.5rem;
-      line-height: 1.7;
+      line-height: 1.0;
     }
   }
 
@@ -1181,6 +1181,7 @@ body.td-documentation .td-main > .row > main .td-content .card {
   ul:has(+ pre) {
     padding-left: 0;
     margin-left: 0;
+    height: 0.8rem
   }
 
   p + .highlight,

content/en/overview/mesh/_index.md

@@ -3,19 +3,16 @@ aliases:
     - /en/overview/mannual/
     - /en/docs3-v2/
     - /en/docs3-v2/
-always_unfold: true
+always_unfold: false
 description: Instructions on how to set up and run Dubbo in Proxyless mode
 linkTitle: Service Mesh
 no_list: true
 title: Dubbo Service Mesh
 type: docs
 weight: 3
 ---
-
 > The service mesh is currently in an early experimental stage. Standard features will be gradually completed and supported.
 
-Instructions on how to set up and run Dubbod in Proxyless mode.
-
 {{< blocks/section color="white" height="auto">}}
 <div class="td-content list-page">
     <div class="lead"></div>
@@ -26,7 +23,7 @@ Instructions on how to set up and run Dubbod in Proxyless mode.
                 <h4 class="card-title">
                     <a href='{{< relref "./getting-started" >}}'>Getting started</a>
                 </h4>
-                <p>Quickly and easily try out Dubbod features.</p>
+                <p>Quickly and easily try out Dubbo features.</p>
             </div>
         </div>
         <div class="col-sm col-md-6 mb-4">
@@ -40,7 +37,7 @@ Instructions on how to set up and run Dubbod in Proxyless mode.
         <div class="col-sm col-md-6 mb-4">
             <div class="h-100">
                 <h4 class="card-title">
-                    <a href='{{< relref "./upgrade" >}}'>Upgrade Dubbod</a>
+                    <a href='{{< relref "./upgrade" >}}'>Upgrade Dubbo</a>
                 </h4>
                 <p>Upgrade, downgrade, and manage Dubbo across multiple control planes.</p>
             </div>

content/en/overview/mesh/concepts/security.md

@@ -5,8 +5,7 @@ title: Security
 type: docs
 weight: 2
 ---
-
-Dubbo Service Mesh security provides strong identities, powerful policies, transparent TLS encryption, and authentication tooling to protect your services and data. It follows the same security model as Istio, but is optimized for the Dubbo protocol and sidecarless architecture.
+> The service mesh is currently in an early experimental stage. Standard features will be gradually completed and supported.
 
 ## High-level architecture
 
@@ -130,6 +129,7 @@ After understanding the basic concepts above, you can:
 
 ## Related content
 
+- [Quickstart](/en/overview/mesh/getting-started/)
 - [Traffic management](/en/overview/mesh/concepts/traffic-management/)
 - [Observability](/en/overview/mesh/concepts/observability/)
 

content/en/overview/mesh/concepts/traffic-management.md

@@ -5,16 +5,14 @@ title: Traffic Management
 type: docs
 weight: 1
 ---
+> The service mesh is currently in an early experimental stage. Resource naming may change.
 
-In Dubbo Service Mesh, traffic management is implemented through the collaboration of the Dubbo control plane and the Dubbo Agent. The control plane generates gRPC xDS configuration based on Kubernetes CRDs and pushes it to Dubbo Agent via the xDS protocol, enabling fine-grained control over inter-service traffic.
-
-## Traffic management overview
+## Introduction
 
 The traffic management model of Dubbo Service Mesh is aligned with Istio, but optimized for the Dubbo protocol and sidecarless architecture. The core components are:
 
 - **ServiceRoute**: defines routing rules and controls how requests are routed to service instances.
 - **SubsetRule**: defines service subsets and traffic policies, such as load balancing, connection pools, TLS settings, etc.
-- **MeshConfig**: mesh-wide configuration, including default traffic policies, trust domain, and more.
 
 By configuring these resources, you can achieve traffic routing, load balancing, and resilience without modifying application code.
 
@@ -26,7 +24,7 @@ ServiceRoute enables you to:
 - Route traffic to different versions of a service (for example, v1 and v2).
 - Route based on request attributes such as headers and paths.
 - Configure weighted routing for canary and gradual rollouts.
-- (Planned) Configure timeouts and retries for resilience.
+- Configure timeouts and retries for resilience.
 
 ### ServiceRoute example
 
@@ -117,13 +115,35 @@ spec:
 
 Subsets are selected based on Pod labels. In the example above, Pods with label `version: v1` are placed into subset `v1`, and Pods with `version: v2` into subset `v2`.
 
-## Other notes
+## Gateway
+
+Gateways provide unified control over ingress and egress traffic in the mesh, allowing you to specify which traffic is allowed to enter or leave the mesh.
+
+Dubbo mesh gateway is implemented based on Kubernetes Gateway API, using Pixiu Gateway as the data plane proxy.
+
+### Gateway example
 
-Because Dubbo Service Mesh uses a sidecarless architecture, the traditional Sidecar resource is replaced by the Dubbo Agent. The Dubbo Agent is embedded into the application process and communicates with the control plane via the xDS protocol.
+```yaml
+apiVersion: gateway.networking.k8s.io/v1
+kind: Gateway
+metadata:
+  name: gateway
+  namespace: dubbo-ingress
+spec:
+  gatewayClassName: dubbo
+  listeners:
+  - name: default
+    hostname: "*.example.com"
+    port: 80
+    protocol: HTTP
+    allowedRoutes:
+      namespaces:
+        from: All
+```
 
 ## Related content
 
-- [Dubbo Service Mesh Quickstart](/en/overview/quickstart/)
+- [Quickstart](/en/overview/mesh/getting-started/)
 - [Security concepts](/en/overview/mesh/concepts/security/)
 - [Observability](/en/overview/mesh/concepts/observability/)
 

content/en/overview/mesh/getting-started.md

@@ -5,36 +5,36 @@ title: Quickstart
 type: docs
 weight: 1
 ---
+> The service mesh is currently in an early experimental stage. Standard features will be gradually completed and supported.
 
-Special thanks to [Megan Yahya's KubeCon EU 2021 talk](https://www.youtube.com/watch?v=cGJXkZ7jiDk) for inspiration and related support.
+Dubbo Service Mesh is a proxyless mesh model developed in 2025. This mode introduces no extra proxy forwarding overhead, making it suitable for all performance-sensitive applications and for any deployment environment.
 
-Dubbo Service Mesh is a proxyless mesh model developed in 2025. In this model, processes communicate directly and interact with the control plane via the xDS protocol.
-
-This mode introduces no extra proxy forwarding overhead, making it suitable for latency-sensitive applications and for any deployment environment.
+- Each deployed application injects a Dubbo Agent that only provides XDS and SDS services, enabling direct inter-service communication through the native gRPC xDS client.
+- All injected agents are based on Kubernetes Gateway API to implement communication between services and external systems.
 
 ## Download Dubbo
 
-1. Go to the Dubbo release page and download the installer for your OS, or automatically download the latest version (Linux or macOS):
+Go to the Dubbo release page and download the installer for your OS, or automatically download the latest version (Linux or macOS):
 
 ```bash
 curl -L https://dubbo.apache.org/downloadDubbo | sh -
 ```
 
-2. Change to the Dubbo package directory:
+Change to the Dubbo package directory:
 
 ```bash
 cd dubbo-x.xx.x
 ```
 
 ## Install Dubbo
 
-1. Install Dubbo with the default profile:
+Install Dubbo with the default profile:
 
 ```bash
 dubboctl install -y
 ```
 
-2. Label the namespace to tell Dubbo to automatically inject the Dubbo Agent when deploying applications:
+Label the namespace to tell Dubbo to automatically inject the Dubbo Agent when deploying applications:
 
 ```bash
 kubectl label namespace default dubbo-injection=enabled
@@ -44,14 +44,15 @@ kubectl label namespace default dubbo-injection=enabled
 <div class="td-content list-page">
     <div class="lead"></div>
     <header class="article-meta"></header>
-    <div class="row justify-content-center">
-        <div class="col-sm col-md-5 mb-4">
-            <div class="h-100 text-center">
-                <a class="btn btn-lg btn-primary mb-3" href='{{< relref "./setup/install" >}}' style="min-width: 200px; color: white;">
-                    Get started with Proxyless mode
-                </a>
-            </div>
-        </div>
+
+    <div style="width:100%; text-align:center;">
+        <a
+            class="btn btn-lg btn-primary"
+            href='{{< relref "./setup/install" >}}'
+            style="min-width:200px; color: white; display: inline-block; margin: 0 auto; transform: translateX(-40px);"
+        >
+            Get started with Proxyless mode
+        </a>
     </div>
 </div>
 {{< /blocks/section >}}

content/en/overview/mesh/setup/install/dubboctl.md

@@ -14,7 +14,7 @@ The `dubboctl` command exposes the full DubboOperator API via command-line flags
 
 Before you begin, check the following prerequisites:
 
-1. [Download the Dubbod release](../../getting-started.md)
+1. [Download the Dubbo release](../../getting-started.md)
 
 ## Install Dubbo using a profile
 
@@ -43,7 +43,7 @@ dubboctl manifest generate > $HOME/generated-manifest.yaml
 To completely uninstall Dubbo from the cluster, run:
 
 ```bash
-istioctl uninstall --remove -y
+dubboctl uninstall --remove -y
 ```
 
 This removes all Dubbo resources. Future versions will support specifying a manifest file.

content/en/overview/mesh/tasks/_index.md

@@ -17,23 +17,23 @@ Learn how to use various Dubbo features through hands-on tasks.
         <div class="col-sm col-md-6 mb-4">
             <div class="h-100">
                 <h4 class="card-title">
-                    <a href='{{< relref "../../mannual/java-sdk/tasks/traffic-management" >}}'>Traffic management</a>
+                    <a href='{{< relref "./traffic-management" >}}'>Traffic management</a>
                 </h4>
                 <p>Learn how to configure and use traffic management features.</p>
             </div>
         </div>
         <div class="col-sm col-md-6 mb-4">
             <div class="h-100">
                 <h4 class="card-title">
-                    <a href='{{< relref "../../mannual/java-sdk/tasks/security" >}}'>Security</a>
+                    <a href='{{< relref "./security" >}}'>Security</a>
                 </h4>
                 <p>Learn how to configure and use security features.</p>
             </div>
         </div>
         <div class="col-sm col-md-6 mb-4">
             <div class="h-100">
                 <h4 class="card-title">
-                    <a href='{{< relref "../../mannual/java-sdk/tasks/observability" >}}'>Observability</a>
+                    <a href='{{< relref "./observability" >}}'>Observability</a>
                 </h4>
                 <p>Learn how to configure and use observability features.</p>
             </div>

content/en/overview/mesh/tasks/observability/_index.md

@@ -0,0 +1,12 @@
+---
+description: Observability tasks
+linkTitle: Observability
+title: Observability
+type: docs
+weight: 3
+---
+
+Learn how to configure and use Dubbo Service Mesh observability features through hands-on tasks.
+
+> Coming soon
+

content/en/overview/mesh/tasks/security/_index.md

@@ -0,0 +1,12 @@
+---
+description: Security tasks
+linkTitle: Security
+title: Security
+type: docs
+weight: 2
+---
+
+Learn how to configure and use Dubbo Service Mesh security features through hands-on tasks.
+
+> Coming soon
+

content/en/overview/mesh/tasks/traffic-management/_index.md

@@ -0,0 +1,28 @@
+---
+description: Traffic management tasks
+linkTitle: Traffic Management
+title: Traffic Management
+type: docs
+weight: 1
+---
+
+Learn how to configure and use Dubbo Service Mesh traffic management features through hands-on tasks.
+
+{{< blocks/section color="white" height="auto">}}
+<div class="td-content list-page">
+    <div class="lead"></div>
+    <header class="article-meta"></header>
+    <div class="row">
+        <div class="col-sm col-md-6 mb-4">
+            <div class="h-100">
+                <h4 class="card-title">
+                    <a href='{{< relref "./ingress" >}}'>Ingress</a>
+                </h4>
+                <p>Learn how to configure and manage ingress traffic.</p>
+            </div>
+        </div>
+    </div>
+    <hr>
+</div>
+{{< /blocks/section >}}
+