This is an automated email from the ASF dual-hosted git repository.

chaokunyang pushed a commit to branch update_docs
in repository https://gitbox.apache.org/repos/asf/fory-site.git

commit bd7efdd9f081820e65e6cc65adb30e696a347794
Author: chaokunyang <[email protected]>
AuthorDate: Tue Aug 4 09:45:29 2026 +0800

    docs: complete getting started guides
---
 docs/start/cpp.md                                  |  82 ++++++++++++++--
 docs/start/csharp.md                               |  59 +++++++++--
 docs/start/dart.md                                 |  68 +++++++++++--
 docs/start/go.md                                   |  70 +++++++++++--
 docs/start/index.md                                |  49 ++++++----
 docs/start/java.md                                 | 108 +++++++++++++++++++--
 docs/start/javascript.md                           |  58 +++++++++--
 docs/start/kotlin.md                               |  57 +++++++++--
 docs/start/python.md                               |  52 ++++++++--
 docs/start/rust.md                                 |  54 +++++++++--
 docs/start/scala.md                                |  54 +++++++++--
 docs/start/swift.md                                |  63 ++++++++++--
 .../current/start/cpp.md                           |  79 ++++++++++++---
 .../current/start/csharp.md                        |  56 +++++++++--
 .../current/start/dart.md                          |  65 +++++++++++--
 .../current/start/go.md                            |  66 ++++++++++---
 .../current/start/index.md                         |  41 ++++----
 .../current/start/java.md                          | 100 ++++++++++++++++---
 .../current/start/javascript.md                    |  55 ++++++++---
 .../current/start/kotlin.md                        |  55 ++++++++---
 .../current/start/python.md                        |  48 ++++++---
 .../current/start/rust.md                          |  51 +++++++---
 .../current/start/scala.md                         |  52 +++++++---
 .../current/start/swift.md                         |  61 ++++++++++--
 24 files changed, 1250 insertions(+), 253 deletions(-)

diff --git a/docs/start/cpp.md b/docs/start/cpp.md
index 837cb81bd9..7e48ce01ab 100644
--- a/docs/start/cpp.md
+++ b/docs/start/cpp.md
@@ -19,7 +19,9 @@ license: |
   limitations under the License.
 ---
 
-Fory C++ is consumed from the Apache Fory source tree. It requires a C++17 
compiler and supports CMake 3.16 or later and Bazel 8 or later. Pin one Fory 
release or commit across every peer in an application.
+Fory C++ provides binary Object Serialization, Row Format, generated models,
+and Fory gRPC. It requires a C++17 compiler and supports CMake 3.16 or later
+and Bazel 8 or later.
 
 ## Verify the Toolchain
 
@@ -29,13 +31,75 @@ cmake --version
 # or: bazel --version
 ```
 
-## Choose a Capability
+## Object Serialization
 
-| Capability                  | Build target                                   
     | Continue with                                                            
                                                                                
                      |
-| --------------------------- | 
--------------------------------------------------- | 
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| Object Serialization        | `fory::serialization` or 
`//cpp/fory/serialization` | [C++ object 
serialization](../object-serialization/cpp/index.md), then choose 
[xlang](../object-serialization/cpp/xlang.md) or 
[native](../object-serialization/cpp/native.md) |
-| Row Format                  | C++ Row and encoder targets                    
     | [C++ Row Format](../row-format/cpp.md)                                   
                                                                                
                      |
-| Schema and generated models | `fory-compiler`                                
     | [Fory IDL and Compiler](../compiler/index.md)                            
                                                                                
                      |
-| Fory gRPC                   | generated companions plus gRPC C++             
     | [C++ gRPC](../grpc/cpp.md)                                               
                                                                                
                      |
+Use xlang mode for data shared with other Fory runtimes or native mode for
+C++-only data. Fetch a released source tree and link the serialization target:
 
-The selected capability guide owns its exact CMake or Bazel setup and first 
runnable example.
+```cmake title="CMakeLists.txt"
+cmake_minimum_required(VERSION 3.16)
+project(fory_example LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+include(FetchContent)
+FetchContent_Declare(
+  fory
+  GIT_REPOSITORY https://github.com/apache/fory.git
+  GIT_TAG v1.5.0
+  SOURCE_SUBDIR cpp
+)
+FetchContent_MakeAvailable(fory)
+
+add_executable(fory_example main.cc)
+target_link_libraries(fory_example PRIVATE fory::serialization)
+```
+
+```cpp title="main.cc"
+#include <cassert>
+#include <cstdint>
+#include <string>
+#include <utility>
+#include <vector>
+
+#include "fory/serialization/fory.h"
+
+struct User {
+  int64_t id;
+  std::string name;
+
+  bool operator==(const User &other) const {
+    return id == other.id && name == other.name;
+  }
+};
+FORY_STRUCT(User, id, name);
+
+int main() {
+  auto fory = fory::serialization::Fory::builder().xlang(true).build();
+  fory.register_struct<User>(1);
+
+  auto bytes = fory.serialize(User{1, "Alice"});
+  assert(bytes.ok());
+  std::vector<uint8_t> data = std::move(bytes).value();
+  auto decoded = fory.deserialize<User>(data);
+  assert(decoded.ok());
+  User user = std::move(decoded).value();
+  assert(user.id == 1 && user.name == "Alice");
+}
+```
+
+```bash
+cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+cmake --build build --parallel
+./build/fory_example
+```
+
+See [C++ Object Serialization](../object-serialization/cpp/index.md) for Bazel,
+Windows, error handling, and thread-safe instances; then continue to
+[xlang](../object-serialization/cpp/xlang.md) or
+[native mode](../object-serialization/cpp/native.md).
+
+## Other Capabilities
+
+- **Row Format** provides random and partial field access for trusted 
analytical data. See [C++ Row Format](../row-format/cpp.md).
+- **Fory IDL and Compiler** generates C++ models and registration helpers. See 
[Compiler Getting Started](../compiler/getting-started.md) and the [C++ 
generated-code guide](../compiler/generated-code/cpp.md).
+- **Fory gRPC** uses gRPC C++ transports with Fory-encoded messages. See [C++ 
gRPC](../grpc/cpp.md).
diff --git a/docs/start/csharp.md b/docs/start/csharp.md
index 545192663f..91ebefcb2f 100644
--- a/docs/start/csharp.md
+++ b/docs/start/csharp.md
@@ -19,7 +19,9 @@ license: |
   limitations under the License.
 ---
 
-Fory C# is published on NuGet as `Apache.Fory` and requires the .NET 8 SDK or 
later. The package includes the runtime and source generator for `ForyStruct` 
types. Use one compatible Fory release across every peer in an application.
+Fory C# provides xlang Object Serialization, generated models, and Fory gRPC.
+The `Apache.Fory` NuGet package requires .NET 8 or later and includes both the
+runtime and source generator.
 
 ## Verify the Toolchain
 
@@ -27,12 +29,53 @@ Fory C# is published on NuGet as `Apache.Fory` and requires 
the .NET 8 SDK or la
 dotnet --version
 ```
 
-## Choose a Capability
+## Object Serialization
 
-| Capability                  | Package or tool                                
  | Continue with                                                               
                                            |
-| --------------------------- | 
------------------------------------------------ | 
-----------------------------------------------------------------------------------------------------------------------
 |
-| Object Serialization        | `Apache.Fory`                                  
  | [C# object serialization](../object-serialization/csharp/index.md) and 
[xlang](../object-serialization/csharp/xlang.md) |
-| Schema and generated models | `fory-compiler`                                
  | [Fory IDL and Compiler](../compiler/index.md)                               
                                            |
-| Fory gRPC                   | generated companions plus gRPC .NET 
dependencies | [C# gRPC](../grpc/csharp.md)                                     
                                                       |
+Create a console project and add the released package:
 
-Each capability guide owns its exact package declaration and first runnable 
example.
+```bash
+dotnet new console -n ForyExample
+cd ForyExample
+dotnet add package Apache.Fory --version 1.5.0
+```
+
+Replace `Program.cs` with:
+
+```csharp
+using Apache.Fory;
+
+[ForyStruct]
+public sealed class User
+{
+    public long Id { get; set; }
+    public string Name { get; set; } = string.Empty;
+}
+
+public static class Program
+{
+    public static void Main()
+    {
+        Fory fory = Fory.Builder().Build();
+        fory.Register<User>(1);
+
+        byte[] bytes = fory.Serialize(new User { Id = 1, Name = "Alice" });
+        User decoded = fory.Deserialize<User>(bytes);
+        Console.WriteLine(decoded.Name);
+    }
+}
+```
+
+```bash
+dotnet run
+```
+
+C# uses xlang mode. Continue with
+[C# Object Serialization](../object-serialization/csharp/index.md),
+[xlang types](../object-serialization/csharp/xlang.md),
+[configuration](../object-serialization/csharp/configuration.md), and
+[schema evolution](../object-serialization/csharp/schema-evolution.md).
+
+## Other Capabilities
+
+- **Fory IDL and Compiler** generates C# models and registration helpers. See 
[Compiler Getting Started](../compiler/getting-started.md) and the [C# 
generated-code guide](../compiler/generated-code/csharp.md).
+- **Fory gRPC** uses normal .NET gRPC transports with Fory-encoded messages. 
See [C# gRPC](../grpc/csharp.md).
diff --git a/docs/start/dart.md b/docs/start/dart.md
index b8f95f41b8..e68c918bbf 100644
--- a/docs/start/dart.md
+++ b/docs/start/dart.md
@@ -19,7 +19,9 @@ license: |
   limitations under the License.
 ---
 
-Fory Dart is published on pub.dev and requires Dart SDK 3.7 or later. 
Generated serializers use `build_runner`. Keep Fory packages and generated code 
in one application on compatible versions.
+Fory Dart provides xlang Object Serialization, generated models, and Fory gRPC.
+It is published on pub.dev, requires Dart 3.7 or later, and uses `build_runner`
+to generate serializers.
 
 ## Verify the Toolchain
 
@@ -28,12 +30,62 @@ dart --version
 dart pub --help
 ```
 
-## Choose a Capability
+## Object Serialization
 
-| Capability                  | Package or tool                          | 
Continue with                                                                   
                                      |
-| --------------------------- | ---------------------------------------- | 
---------------------------------------------------------------------------------------------------------------------
 |
-| Object Serialization        | `fory` plus `build_runner`               | 
[Dart object serialization](../object-serialization/dart/index.md) and 
[xlang](../object-serialization/dart/xlang.md) |
-| Schema and generated models | `fory-compiler`                          | 
[Fory IDL and Compiler](../compiler/index.md)                                   
                                      |
-| Fory gRPC                   | generated companions plus `package:grpc` | 
[Dart gRPC](../grpc/dart.md)                                                    
                                      |
+Add Fory and the generator to `pubspec.yaml`:
 
-Each capability guide owns its exact `pubspec.yaml`, generation command, and 
first runnable example.
+```yaml
+dependencies:
+  fory: 1.5.0
+
+dev_dependencies:
+  build_runner: ^2.4.0
+```
+
+Create `lib/person.dart`:
+
+```dart
+import 'package:fory/fory.dart';
+
+part 'person.fory.dart';
+
+@ForyStruct()
+class Person {
+  Person();
+
+  @ForyField(type: Int64Type())
+  int id = 0;
+  String name = '';
+}
+
+void main() {
+  final fory = Fory();
+  PersonForyModule.register(fory, Person, name: 'example.Person');
+
+  final input = Person()
+    ..id = 1
+    ..name = 'Alice';
+  final bytes = fory.serialize(input);
+  final decoded = fory.deserialize<Person>(bytes);
+  print(decoded.name);
+}
+```
+
+Generate the serializer and run the example:
+
+```bash
+dart pub get
+dart run build_runner build
+dart run lib/person.dart
+```
+
+Dart uses xlang mode. Continue with
+[Dart Object Serialization](../object-serialization/dart/index.md),
+[code generation](../object-serialization/dart/code-generation.md),
+[web support](../object-serialization/dart/web-platform-support.md), and
+[schema evolution](../object-serialization/dart/schema-evolution.md).
+
+## Other Capabilities
+
+- **Fory IDL and Compiler** generates Dart models and registration helpers. 
See [Compiler Getting Started](../compiler/getting-started.md) and the [Dart 
generated-code guide](../compiler/generated-code/dart.md).
+- **Fory gRPC** uses package:grpc transports with Fory-encoded messages. See 
[Dart gRPC](../grpc/dart.md).
diff --git a/docs/start/go.md b/docs/start/go.md
index fff98fe6ef..dc545e8f86 100644
--- a/docs/start/go.md
+++ b/docs/start/go.md
@@ -19,7 +19,9 @@ license: |
   limitations under the License.
 ---
 
-Fory Go is published as the Go module `github.com/apache/fory/go/fory` and 
requires Go 1.24 or later. Use one compatible Fory release across every peer in 
an application.
+Fory Go provides xlang and native Object Serialization, generated models, and
+Fory gRPC. It is published as `github.com/apache/fory/go/fory` and requires Go
+1.25 or later.
 
 ## Verify the Toolchain
 
@@ -28,14 +30,64 @@ go version
 go env GOPROXY
 ```
 
-If a Go proxy has not picked up a new submodule tag yet, retry later or use 
`GOPROXY=direct` temporarily.
+## Object Serialization
 
-## Choose a Capability
+Create a module and install the released Fory module:
 
-| Capability                  | Module or tool                    | Continue 
with                                                                            
                                                                                
  |
-| --------------------------- | --------------------------------- | 
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| Object Serialization        | `github.com/apache/fory/go/fory`  | [Go object 
serialization](../object-serialization/go/index.md), then choose 
[xlang](../object-serialization/go/xlang.md) or 
[native](../object-serialization/go/native.md) |
-| Schema and generated models | `fory-compiler`                   | [Fory IDL 
and Compiler](../compiler/index.md)                                             
                                                                                
 |
-| Fory gRPC                   | generated companions plus grpc-go | [Go 
gRPC](../grpc/go.md)                                                            
                                                                                
       |
+```bash
+mkdir fory-example
+cd fory-example
+go mod init example.com/fory-example
+go get github.com/apache/fory/go/[email protected]
+```
+
+If a Go proxy has not picked up a new submodule tag yet, retry later or use
+`GOPROXY=direct` temporarily.
+
+```go title="main.go"
+package main
+
+import (
+    "fmt"
+
+    "github.com/apache/fory/go/fory"
+)
+
+type User struct {
+    ID   int64
+    Name string
+}
+
+func main() {
+    f := fory.New(fory.WithXlang(true))
+    if err := f.RegisterStruct(User{}, 1); err != nil {
+        panic(err)
+    }
+
+    bytes, err := f.Serialize(&User{ID: 1, Name: "Alice"})
+    if err != nil {
+        panic(err)
+    }
+
+    var decoded User
+    if err := f.Deserialize(bytes, &decoded); err != nil {
+        panic(err)
+    }
+    fmt.Println(decoded.Name)
+}
+```
+
+```bash
+go run .
+```
+
+Use [xlang mode](../object-serialization/go/xlang.md) for cross-language data
+and [native mode](../object-serialization/go/native.md) for Go-only data.
+Continue with [Go Object Serialization](../object-serialization/go/index.md),
+[configuration](../object-serialization/go/configuration.md), and
+[schema evolution](../object-serialization/go/schema-evolution.md).
+
+## Other Capabilities
 
-Each capability guide owns its exact module command and first runnable example.
+- **Fory IDL and Compiler** generates Go models and registration helpers. See 
[Compiler Getting Started](../compiler/getting-started.md) and the [Go 
generated-code guide](../compiler/generated-code/go.md).
+- **Fory gRPC** uses grpc-go transports with Fory-encoded messages. See [Go 
gRPC](../grpc/go.md).
diff --git a/docs/start/index.md b/docs/start/index.md
index da24c38d57..3575ff456a 100644
--- a/docs/start/index.md
+++ b/docs/start/index.md
@@ -19,14 +19,27 @@ license: |
   limitations under the License.
 ---
 
-Apache Fory™ releases are available both as source artifacts and 
language-specific packages.
+Start with a runtime page below. Each page includes a release-pinned 
installation,
+a runnable object-serialization round trip, the modes supported by that 
runtime,
+and a short path into every additional Fory capability available there.
 
-For source downloads, see the Apache Fory™ 
[download](https://fory.apache.org/download) page.
+Apache Fory™ releases are available as source artifacts and language-specific
+packages. For source downloads, see the Apache Fory™
+[download](https://fory.apache.org/download) page.
+
+## First Five Minutes
+
+1. Choose the runtime used by your application.
+2. Install the package shown on that runtime page.
+3. Run its minimal serialize/deserialize example.
+4. Select xlang mode for cross-language data or native mode for same-runtime 
data
+   when both are available.
+5. Continue to the capability guide for production configuration and advanced 
APIs.
 
 ## Choose a Runtime
 
-Each runtime setup page checks the toolchain and routes to the capabilities 
that
-runtime supports:
+Each runtime page provides a release-pinned installation snippet, a minimal
+round trip for an application project, and the next capability-specific steps:
 
 | Runtime               | Setup                                  |
 | --------------------- | -------------------------------------- |
@@ -42,21 +55,17 @@ runtime supports:
 | Scala                 | [Scala](scala.md)                      |
 | Kotlin                | [Kotlin](kotlin.md)                    |
 
-## Choose a Capability
-
-| Need                                | Continue with                          
                  |
-| ----------------------------------- | 
-------------------------------------------------------- |
-| Reconstruct object graphs           | [Object 
Serialization](../object-serialization/index.md) |
-| Random or partial analytical access | [Row Format](../row-format/index.md)   
                  |
-| Exchange standard JSON from Java    | [Fory JSON](../json/index.md)          
                  |
-| Generate models from a schema       | [Fory IDL and 
Compiler](../compiler/index.md)            |
-| Use generated models over gRPC      | [Fory gRPC](../grpc/index.md)          
                  |
+## What You Can Build
 
-Object Serialization then asks you to choose xlang mode for portable
-cross-language payloads or native mode for same-runtime payloads. Use
-[Choose a Format](../introduction/choose-a-format.md) when that product 
decision
-is not yet clear.
+| Capability           | Use it for                                            
                         | Available runtimes                                   
            | Detailed guide                                           |
+| -------------------- | 
------------------------------------------------------------------------------ 
| ---------------------------------------------------------------- | 
-------------------------------------------------------- |
+| Object Serialization | Reconstruct object graphs, including shared 
references and schema changes      | All runtimes                               
                      | [Object 
Serialization](../object-serialization/index.md) |
+| Row Format           | Trusted analytical data with zero-copy, random, or 
partial field access        | Java, Python, C++, Rust                           
               | [Row Format](../row-format/index.md)                     |
+| Fory JSON            | High-performance standard JSON mapping                
                         | Java                                                 
            | [Fory JSON](../json/index.md)                            |
+| Fory IDL             | Generate native models and serializers from Fory, 
protobuf, or FlatBuffers IDL | All runtimes                                     
                | [Fory IDL and Compiler](../compiler/index.md)            |
+| Fory gRPC            | Use generated models over normal gRPC transports with 
Fory-encoded messages    | Java, Python, C++, Go, Rust, JavaScript, C#, Dart, 
Scala, Kotlin | [Fory gRPC](../grpc/index.md)                            |
 
-The selected capability guide owns its exact dependency and first successful
-task. Schema compatibility settings and production configuration are
-runtime-specific.
+Object Serialization uses xlang mode for portable cross-language data. Java,
+Python, C++, Go, Rust, Scala, and Kotlin also offer native mode for
+same-runtime data. Use [Choose a Format](../introduction/choose-a-format.md)
+when the product choice is not yet clear.
diff --git a/docs/start/java.md b/docs/start/java.md
index 314b4f09b6..9bb6ce224b 100644
--- a/docs/start/java.md
+++ b/docs/start/java.md
@@ -19,7 +19,11 @@ license: |
   limitations under the License.
 ---
 
-Fory Java artifacts are published to Maven Central. Fory core supports Java 8 
and later; Java Records require Java 17 or later, and Row Format requires Java 
11 or later. Keep every Fory artifact in one application on the same version.
+Fory Java provides binary Object Serialization, Fory JSON, Row Format, 
generated
+models, and Fory gRPC. Artifacts are published to Maven Central. Fory core and
+Fory JSON support Java 8 and later, Java Records require Java 17 or later, and
+Row Format requires Java 11 or later. Keep every Fory artifact in one 
application
+on the same version.
 
 ## Verify the Toolchain
 
@@ -29,14 +33,98 @@ mvn -version
 # or: ./gradlew --version
 ```
 
-## Choose a Capability
+## Object Serialization
 
-| Capability                  | Artifact or tool                               
  | Continue with                                                               
                                                                                
                       |
-| --------------------------- | 
------------------------------------------------ | 
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| Object Serialization        | `fory-core`                                    
  | [Java object serialization](../object-serialization/java/index.md), then 
choose [xlang](../object-serialization/java/xlang.md) or 
[native](../object-serialization/java/native.md) |
-| Fory JSON                   | `fory-json`                                    
  | [Fory JSON Getting Started](../json/getting-started.md)                     
                                                                                
                       |
-| Row Format                  | `fory-format`                                  
  | [Java Row Format](../row-format/java.md)                                    
                                                                                
                       |
-| Schema and generated models | `fory-compiler`                                
  | [Fory IDL and Compiler](../compiler/index.md)                               
                                                                                
                       |
-| Fory gRPC                   | generated companions plus gRPC Java 
dependencies | [Java gRPC](../grpc/java.md)                                     
                                                                                
                                  |
+Use Object Serialization for object graphs. Xlang mode produces data that other
+Fory runtimes can read; native mode supports a broader JVM object surface.
 
-Each capability guide owns its exact dependency declaration and first runnable 
example.
+Maven:
+
+```xml
+<dependency>
+  <groupId>org.apache.fory</groupId>
+  <artifactId>fory-core</artifactId>
+  <version>1.5.0</version>
+</dependency>
+```
+
+Gradle:
+
+```kotlin
+implementation("org.apache.fory:fory-core:1.5.0")
+```
+
+Run this complete xlang round trip:
+
+```java
+import org.apache.fory.Fory;
+
+public final class ForyExample {
+  public static final class User {
+    public long id;
+    public String name;
+
+    public User() {}
+
+    public User(long id, String name) {
+      this.id = id;
+      this.name = name;
+    }
+  }
+
+  public static void main(String[] args) {
+    Fory fory = Fory.builder().withXlang(true).build();
+    fory.register(User.class, 1);
+
+    byte[] bytes = fory.serialize(new User(1, "Alice"));
+    User decoded = (User) fory.deserialize(bytes);
+    System.out.println(decoded.name);
+  }
+}
+```
+
+Reuse a `Fory` instance instead of rebuilding it for every value. Continue with
+[Java Object Serialization](../object-serialization/java/index.md),
+[xlang mode](../object-serialization/java/xlang.md),
+[native mode](../object-serialization/java/native.md), or
+[configuration](../object-serialization/java/configuration.md).
+
+## Fory JSON
+
+Fory JSON maps Java objects to standard JSON text and UTF-8 bytes. Add
+`fory-json` instead of `fory-core` when the application only needs JSON:
+
+```kotlin
+implementation("org.apache.fory:fory-json:1.5.0")
+```
+
+Add the import to `ForyExample.java`:
+
+```java
+import org.apache.fory.json.ForyJson;
+```
+
+Then place the JSON round trip inside `ForyExample.main`:
+
+```java
+ForyJson json = ForyJson.builder().build();
+String text = json.toJson(new User(1, "Alice"));
+User jsonDecoded = json.fromJson(text, User.class);
+System.out.println(jsonDecoded.name);
+```
+
+See [Fory JSON Getting Started](../json/getting-started.md) for Maven setup,
+object mapping, annotations, Android, GraalVM, and security.
+
+## Other Capabilities
+
+- **Row Format** provides random and partial field access for trusted 
analytical data. See [Java Row Format](../row-format/java.md).
+- **Fory IDL and Compiler** generates Java models and registration helpers 
from Fory IDL, protobuf IDL, or FlatBuffers IDL. See [Compiler Getting 
Started](../compiler/getting-started.md) and the [Java generated-code 
guide](../compiler/generated-code/java.md).
+- **Fory gRPC** uses normal grpc-java transports with Fory-encoded request and 
response objects. See [Java gRPC](../grpc/java.md).
+
+## Runtime Notes
+
+- On JDK 25 and later, follow the setup in
+  [Java Object Serialization](../object-serialization/java/index.md).
+- For Android, see [Java Android 
support](../object-serialization/java/android.md).
+- For native images, see [Java GraalVM 
support](../object-serialization/java/graalvm.md).
diff --git a/docs/start/javascript.md b/docs/start/javascript.md
index 144b41652e..3e3cc755db 100644
--- a/docs/start/javascript.md
+++ b/docs/start/javascript.md
@@ -19,7 +19,10 @@ license: |
   limitations under the License.
 ---
 
-Fory JavaScript/TypeScript packages are published on npm. The core package 
works without native acceleration; the optional `@apache-fory/hps` Node.js fast 
path requires Node.js 20 or later. Keep Fory packages in one application on 
compatible versions.
+Fory JavaScript/TypeScript provides xlang Object Serialization, generated
+models, Node.js gRPC, and browser gRPC-Web clients. Packages are published on
+npm. The core package works without native acceleration; the optional
+`@apache-fory/hps` Node.js fast path requires Node.js 20 or later.
 
 ## Verify the Toolchain
 
@@ -28,12 +31,51 @@ node --version
 npm --version
 ```
 
-## Choose a Capability
+## Object Serialization
 
-| Capability                  | Package or tool                                
  | Continue with                                                               
                                                                       |
-| --------------------------- | 
------------------------------------------------ | 
--------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| Object Serialization        | `@apache-fory/core`; optional 
`@apache-fory/hps` | [JavaScript/TypeScript object 
serialization](../object-serialization/javascript/index.md) and 
[xlang](../object-serialization/javascript/xlang.md) |
-| Schema and generated models | `fory-compiler`                                
  | [Fory IDL and Compiler](../compiler/index.md)                               
                                                                       |
-| Fory gRPC                   | generated Node.js or gRPC-Web companions       
  | [JavaScript gRPC](../grpc/javascript.md)                                    
                                                                       |
+Install the core package:
 
-Each capability guide owns its exact install command, environment-specific 
setup, and first runnable example.
+```bash
+npm install @apache-fory/[email protected]
+```
+
+Define a schema and run an xlang round trip:
+
+```js title="example.mjs"
+import Fory, { Type } from "@apache-fory/core";
+
+const userType = Type.struct(
+  { typeName: "example.User" },
+  {
+    id: Type.int64(),
+    name: Type.string(),
+  },
+);
+
+const fory = new Fory();
+const { serialize, deserialize } = fory.register(userType);
+
+const bytes = serialize({ id: 1n, name: "Alice" });
+console.log(deserialize(bytes));
+```
+
+```bash
+node example.mjs
+```
+
+JavaScript uses xlang mode. Continue with
+[JavaScript/TypeScript Object 
Serialization](../object-serialization/javascript/index.md),
+[xlang types](../object-serialization/javascript/xlang.md),
+[configuration](../object-serialization/javascript/configuration.md), and
+[schema evolution](../object-serialization/javascript/schema-evolution.md).
+
+For the optional Node.js string fast path, install the matching package 
version:
+
+```bash
+npm install @apache-fory/[email protected] @apache-fory/[email protected]
+```
+
+## Other Capabilities
+
+- **Fory IDL and Compiler** generates TypeScript interfaces, schemas, and 
registration helpers. See [Compiler Getting 
Started](../compiler/getting-started.md) and the [JavaScript generated-code 
guide](../compiler/generated-code/javascript.md).
+- **Fory gRPC** supports Node.js gRPC and browser gRPC-Web transports with 
Fory-encoded messages. See [JavaScript gRPC](../grpc/javascript.md).
diff --git a/docs/start/kotlin.md b/docs/start/kotlin.md
index 22139e7169..ad9768d65d 100644
--- a/docs/start/kotlin.md
+++ b/docs/start/kotlin.md
@@ -19,7 +19,8 @@ license: |
   limitations under the License.
 ---
 
-Fory Kotlin artifacts are published to Maven Central and run on Fory Java. 
Fory core supports Java 8 and later. Keep Kotlin, Java core, and generated-code 
artifacts in one application on the same Fory release.
+Fory Kotlin provides binary Object Serialization, generated models, Fory gRPC,
+and Android support. It runs on Fory Java and supports Java 8 and later.
 
 ## Verify the Toolchain
 
@@ -29,13 +30,51 @@ java -version
 # or: mvn -version
 ```
 
-## Choose a Capability
+## Object Serialization
 
-| Capability                   | Artifact or tool                              
  | Continue with                                                               
                                                                                
                               |
-| ---------------------------- | 
----------------------------------------------- | 
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| Object Serialization         | `fory-kotlin`                                 
  | [Kotlin object serialization](../object-serialization/kotlin/index.md), 
then choose [xlang](../object-serialization/kotlin/xlang.md) or 
[native](../object-serialization/kotlin/native.md) |
-| Schema and generated models  | `fory-compiler` and Kotlin KSP support        
  | [Fory IDL and Compiler](../compiler/index.md)                               
                                                                                
                               |
-| Fory gRPC                    | generated coroutine companions plus 
grpc-kotlin | [Kotlin gRPC](../grpc/kotlin.md)                                  
                                                                                
                                         |
-| Android object serialization | `fory-kotlin` plus generated serializers      
  | [Android](../object-serialization/java/android.md)                          
                                                                                
                               |
+Add the runtime to the application module:
 
-Each capability guide owns its exact Maven or Gradle declaration and first 
runnable example.
+```kotlin title="build.gradle.kts"
+dependencies {
+  implementation("org.apache.fory:fory-kotlin:1.5.0")
+}
+```
+
+Create `src/main/kotlin/KotlinExample.kt`:
+
+```kotlin
+import org.apache.fory.ThreadSafeFory
+import org.apache.fory.kotlin.ForyKotlin
+
+data class User(val id: Long, val name: String)
+
+fun main() {
+    val fory: ThreadSafeFory = ForyKotlin.builder()
+        .withXlang(true)
+        .requireClassRegistration(true)
+        .buildThreadSafeFory()
+    fory.register(User::class.java, 1)
+
+    val bytes = fory.serialize(User(1, "Alice"))
+    val decoded = fory.deserialize(bytes) as User
+    println(decoded.name)
+}
+```
+
+If the project applies Gradle's `application` plugin, run its application task:
+
+```bash
+./gradlew run
+```
+
+Use xlang mode for data shared with other Fory runtimes or native mode for
+Kotlin/JVM-only data. Continue with
+[Kotlin Object Serialization](../object-serialization/kotlin/index.md),
+[xlang](../object-serialization/kotlin/xlang.md), or
+[native mode](../object-serialization/kotlin/native.md).
+
+## Other Capabilities
+
+- **Fory IDL and Compiler** generates Kotlin models and registration helpers 
through KSP. See [Compiler Getting Started](../compiler/getting-started.md) and 
the [Kotlin generated-code guide](../compiler/generated-code/kotlin.md).
+- **Fory gRPC** uses grpc-kotlin and grpc-java transports with Fory-encoded 
messages. See [Kotlin gRPC](../grpc/kotlin.md).
+- **Android** uses generated serializers with the same Fory Kotlin runtime. 
See [Android Object Serialization](../object-serialization/java/android.md).
diff --git a/docs/start/python.md b/docs/start/python.md
index cd9c233121..4f3d03a9d2 100644
--- a/docs/start/python.md
+++ b/docs/start/python.md
@@ -19,7 +19,9 @@ license: |
   limitations under the License.
 ---
 
-Python packages are published on PyPI. `pyfory` supports Python 3.8 and later 
on Linux, macOS, and Windows. Use one compatible Fory release across every peer 
in an application.
+`pyfory` provides binary Object Serialization and Row Format. Fory IDL can also
+generate Python models and gRPC companions. The package supports Python 3.8 and
+later on Linux, macOS, and Windows.
 
 ## Verify the Toolchain
 
@@ -28,13 +30,45 @@ python --version
 python -m pip --version
 ```
 
-## Choose a Capability
+## Object Serialization
 
-| Capability                  | Package or extra       | Continue with         
                                                                                
                                                                                
     |
-| --------------------------- | ---------------------- | 
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| Object Serialization        | `pyfory`               | [Python object 
serialization](../object-serialization/python/index.md), then choose 
[xlang](../object-serialization/python/xlang.md) or 
[native](../object-serialization/python/native.md) |
-| Row Format                  | `pyfory[format]`       | [Python Row 
Format](../row-format/python.md)                                                
                                                                                
               |
-| Schema and generated models | `fory-compiler`        | [Fory IDL and 
Compiler](../compiler/index.md)                                                 
                                                                                
             |
-| Fory gRPC                   | `pyfory` plus `grpcio` | [Python 
gRPC](../grpc/python.md)                                                        
                                                                                
                   |
+Install the released package:
 
-Each capability guide owns its exact install command and first runnable 
example.
+```bash
+python -m pip install pyfory==1.5.0
+```
+
+Run an xlang round trip:
+
+```python
+from dataclasses import dataclass
+
+import pyfory
+
+
+@dataclass
+class User:
+    name: str
+    age: pyfory.Int32
+
+
+fory = pyfory.Fory(xlang=True, ref=True)
+fory.register(User, type_id=1)
+
+data = fory.serialize(User("Alice", 30))
+decoded = fory.deserialize(data)
+print(decoded)
+```
+
+Use [xlang mode](../object-serialization/python/xlang.md) for cross-language
+data. Use [native mode](../object-serialization/python/native.md) for 
Python-only
+objects, including Python callables and serialization hooks. Continue with the
+[Python guide](../object-serialization/python/index.md),
+[configuration](../object-serialization/python/configuration.md), and
+[type registration](../object-serialization/python/type-registration.md).
+
+## Other Capabilities
+
+- **Row Format** provides zero-copy field access for trusted analytical data. 
See [Python Row Format](../row-format/python.md).
+- **Fory IDL and Compiler** generates Python models and registration helpers. 
See [Compiler Getting Started](../compiler/getting-started.md) and the [Python 
generated-code guide](../compiler/generated-code/python.md).
+- **Fory gRPC** uses grpcio transports with Fory-encoded messages. See [Python 
gRPC](../grpc/python.md).
diff --git a/docs/start/rust.md b/docs/start/rust.md
index 9ae691e426..30f4303c74 100644
--- a/docs/start/rust.md
+++ b/docs/start/rust.md
@@ -19,7 +19,9 @@ license: |
   limitations under the License.
 ---
 
-Fory Rust is published on crates.io. The workspace minimum supported Rust 
version is 1.70 and uses the Rust 2021 edition. Use one compatible Fory release 
across every peer in an application.
+Fory Rust provides xlang and native Object Serialization, standard Row Format,
+generated models, and Fory gRPC. The public `fory` crate is published on
+crates.io, supports Rust 1.70 or later, and uses the Rust 2021 edition.
 
 ## Verify the Toolchain
 
@@ -28,13 +30,47 @@ rustc --version
 cargo --version
 ```
 
-## Choose a Capability
+## Object Serialization
 
-| Capability                  | Crate or tool                                 
| Continue with                                                                 
                                                                                
                     |
-| --------------------------- | --------------------------------------------- 
| 
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| Object Serialization        | `fory`                                        
| [Rust object serialization](../object-serialization/rust/index.md), then 
choose [xlang](../object-serialization/rust/xlang.md) or 
[native](../object-serialization/rust/native.md) |
-| Standard Row Format         | `fory`                                        
| [Rust Row Format](../row-format/rust.md)                                      
                                                                                
                     |
-| Schema and generated models | `fory-compiler`                               
| [Fory IDL and Compiler](../compiler/index.md)                                 
                                                                                
                     |
-| Fory gRPC                   | generated companions plus `tonic` and `bytes` 
| [Rust gRPC](../grpc/rust.md)                                                  
                                                                                
                     |
+Add the public crate:
 
-Each capability guide owns its exact dependency declaration and first runnable 
example.
+```toml title="Cargo.toml"
+[dependencies]
+fory = "1.5.0"
+```
+
+```rust
+use fory::{Error, Fory, ForyStruct};
+
+#[derive(ForyStruct, Debug, PartialEq)]
+struct User {
+    id: i64,
+    name: String,
+}
+
+fn main() -> Result<(), Error> {
+    let mut fory = Fory::builder().xlang(true).build();
+    fory.register::<User>(1)?;
+
+    let user = User {
+        id: 1,
+        name: "Alice".to_string(),
+    };
+    let bytes = fory.serialize(&user)?;
+    let decoded: User = fory.deserialize(&bytes)?;
+    assert_eq!(user, decoded);
+    Ok(())
+}
+```
+
+Use [xlang mode](../object-serialization/rust/xlang.md) for cross-language data
+and [native mode](../object-serialization/rust/native.md) for Rust-only data.
+Continue with [Rust Object 
Serialization](../object-serialization/rust/index.md),
+[configuration](../object-serialization/rust/configuration.md), and
+[type registration](../object-serialization/rust/type-registration.md).
+
+## Other Capabilities
+
+- **Row Format** provides zero-copy views over trusted analytical data using 
the standard Fory Row layout. See [Rust Row Format](../row-format/rust.md).
+- **Fory IDL and Compiler** generates Rust models and registration helpers. 
See [Compiler Getting Started](../compiler/getting-started.md) and the [Rust 
generated-code guide](../compiler/generated-code/rust.md).
+- **Fory gRPC** uses tonic transports with Fory-encoded messages. See [Rust 
gRPC](../grpc/rust.md).
diff --git a/docs/start/scala.md b/docs/start/scala.md
index 6101958a17..974038f1a5 100644
--- a/docs/start/scala.md
+++ b/docs/start/scala.md
@@ -19,7 +19,9 @@ license: |
   limitations under the License.
 ---
 
-Fory Scala artifacts are published to Maven Central for Scala 2.13 and Scala 
3. Schema-generated Scala sources and macro-derived xlang serializers require 
Scala 3. The runtime uses Fory Java, so keep all Fory artifacts on the same 
release.
+Fory Scala provides binary Object Serialization, generated models, and Fory
+gRPC. The runtime artifact supports Scala 2.13 and Scala 3; generated Scala
+models require Scala 3.
 
 ## Verify the Toolchain
 
@@ -29,12 +31,48 @@ scala -version
 sbt --version
 ```
 
-## Choose a Capability
+## Object Serialization
 
-| Capability                  | Artifact or tool                            | 
Continue with                                                                   
                                                                                
                       |
-| --------------------------- | ------------------------------------------- | 
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| Object Serialization        | `fory-scala_2.13` or `fory-scala_3`         | 
[Scala object serialization](../object-serialization/scala/index.md), then 
choose [xlang](../object-serialization/scala/xlang.md) or 
[native](../object-serialization/scala/native.md) |
-| Schema and generated models | `fory-compiler`; Scala 3 output             | 
[Fory IDL and Compiler](../compiler/index.md)                                   
                                                                                
                       |
-| Fory gRPC                   | Scala 3 generated companions plus grpc-java | 
[Scala gRPC](../grpc/scala.md)                                                  
                                                                                
                       |
+Add the runtime to `build.sbt`:
 
-Each capability guide owns its exact Maven or sbt declaration and first 
runnable example.
+```sbt
+ThisBuild / scalaVersion := "3.3.1"
+libraryDependencies += "org.apache.fory" %% "fory-scala" % "1.5.0"
+```
+
+Create `src/main/scala/ScalaExample.scala`:
+
+```scala
+import org.apache.fory.Fory
+import org.apache.fory.scala.ForyScala
+
+case class User(id: Long, name: String)
+
+object ScalaExample {
+  def main(args: Array[String]): Unit = {
+    val fory: Fory = ForyScala.builder()
+      .withXlang(true)
+      .build()
+    fory.register(classOf[User], 1)
+
+    val bytes = fory.serialize(User(1, "Alice"))
+    val decoded = fory.deserialize(bytes).asInstanceOf[User]
+    println(decoded.name)
+  }
+}
+```
+
+```bash
+sbt run
+```
+
+Use xlang mode for data shared with other Fory runtimes or native mode for
+Scala/JVM-only data. Continue with
+[Scala Object Serialization](../object-serialization/scala/index.md),
+[xlang](../object-serialization/scala/xlang.md), or
+[native mode](../object-serialization/scala/native.md).
+
+## Other Capabilities
+
+- **Fory IDL and Compiler** generates Scala 3 models and registration helpers. 
See [Compiler Getting Started](../compiler/getting-started.md) and the [Scala 
generated-code guide](../compiler/generated-code/scala.md).
+- **Fory gRPC** uses grpc-java transports with Fory-encoded messages. See 
[Scala gRPC](../grpc/scala.md).
diff --git a/docs/start/swift.md b/docs/start/swift.md
index af494457c8..7118e7d9c7 100644
--- a/docs/start/swift.md
+++ b/docs/start/swift.md
@@ -19,7 +19,9 @@ license: |
   limitations under the License.
 ---
 
-Fory Swift is distributed through Swift Package Manager from the Apache Fory 
repository. The current package uses Swift tools 6.0 and targets macOS 13 or 
later and iOS 16 or later. Pin one Fory release across every peer in an 
application.
+Fory Swift provides xlang Object Serialization and compiler-generated models.
+It is distributed through Swift Package Manager, uses Swift tools 6.0, and
+targets macOS 13 or later and iOS 16 or later.
 
 ## Verify the Toolchain
 
@@ -27,11 +29,58 @@ Fory Swift is distributed through Swift Package Manager 
from the Apache Fory rep
 swift --version
 ```
 
-## Choose a Capability
+## Object Serialization
 
-| Capability                  | Package product or tool      | Continue with   
                                                                                
                         |
-| --------------------------- | ---------------------------- | 
------------------------------------------------------------------------------------------------------------------------
 |
-| Object Serialization        | Swift package product `Fory` | [Swift object 
serialization](../object-serialization/swift/index.md) and 
[xlang](../object-serialization/swift/xlang.md) |
-| Schema and generated models | `fory-compiler`              | [Fory IDL and 
Compiler](../compiler/index.md)                                                 
                           |
+Create an executable package:
 
-The selected capability guide owns its exact package declaration and first 
runnable example.
+```bash
+swift package init --type executable --name ForyExample
+```
+
+Add the released package and `Fory` product to the generated `Package.swift`:
+
+```swift title="Package.swift"
+dependencies: [
+    .package(url: "https://github.com/apache/fory.git";, exact: "1.5.0")
+],
+targets: [
+    .executableTarget(
+        name: "ForyExample",
+        dependencies: [.product(name: "Fory", package: "fory")]
+    )
+]
+```
+
+Replace `Sources/main.swift` with:
+
+```swift title="Sources/main.swift"
+import Fory
+
+@ForyStruct
+struct User: Equatable {
+    var id: Int64 = 0
+    var name: String = ""
+}
+
+let fory = Fory()
+try fory.register(User.self, id: 1)
+
+let input = User(id: 1, name: "Alice")
+let bytes = try fory.serialize(input)
+let decoded: User = try fory.deserialize(bytes)
+assert(input == decoded)
+```
+
+```bash
+swift run
+```
+
+Swift uses xlang mode. Continue with
+[Swift Object Serialization](../object-serialization/swift/index.md),
+[xlang types](../object-serialization/swift/xlang.md),
+[configuration](../object-serialization/swift/configuration.md), and
+[schema evolution](../object-serialization/swift/schema-evolution.md).
+
+## Other Capabilities
+
+- **Fory IDL and Compiler** generates Swift models and registration helpers. 
See [Compiler Getting Started](../compiler/getting-started.md) and the [Swift 
generated-code guide](../compiler/generated-code/swift.md).
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/cpp.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/cpp.md
index b4822c7528..7f4f7dd654 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/cpp.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/cpp.md
@@ -1,5 +1,5 @@
 ---
-title: C++ 环境配置
+title: C++ 设置
 sidebar_position: 3
 id: cpp
 license: |
@@ -19,8 +19,7 @@ license: |
   limitations under the License.
 ---
 
-Fory C++ 直接从 Apache Fory 源代码树使用。它需要 C++17 编译器,并支持 CMake 3.16 或更高
-版本以及 Bazel 8 或更高版本。一个应用的所有对等端应固定使用同一 Fory 发行版或 commit。
+Fory C++ 提供二进制对象序列化、Row Format、生成的模型和 Fory gRPC。它需要 C++17 编译器,并支持 CMake 3.16 
及更高版本和 Bazel 8 及更高版本。
 
 ## 验证工具链
 
@@ -30,13 +29,71 @@ cmake --version
 # or: bazel --version
 ```
 
-## 选择能力
+## 对象序列化
 
-| 能力              | 构建目标                                            | 后续文档     
                                                                                
                                                                     |
-| ----------------- | --------------------------------------------------- | 
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| 对象序列化        | `fory::serialization` 或 `//cpp/fory/serialization` | [C++ 
对象序列化](../object-serialization/cpp/index.md),然后选择 
[xlang](../object-serialization/cpp/xlang.md) 或 
[native](../object-serialization/cpp/native.md) |
-| Row Format        | C++ Row 和编码器目标                                | [C++ Row 
Format](../row-format/cpp.md)                                                   
                                                                         |
-| Schema 和生成模型 | `fory-compiler`                                     | [Fory 
IDL 和编译器](../compiler/index.md)                                                 
                                                                        |
-| Fory gRPC         | 生成的配套代码加 gRPC C++                           | [C++ 
gRPC](../grpc/cpp.md)                                                           
                                                                             |
+与其他 Fory 运行时共享的数据使用 xlang 模式,仅供 C++ 使用的数据使用 native 模式。获取已发布的源代码树,并链接序列化目标:
 
-所选能力指南会提供确切的 CMake 或 Bazel 配置以及首个可运行示例。
+```cmake title="CMakeLists.txt"
+cmake_minimum_required(VERSION 3.16)
+project(fory_example LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+include(FetchContent)
+FetchContent_Declare(
+  fory
+  GIT_REPOSITORY https://github.com/apache/fory.git
+  GIT_TAG v1.5.0
+  SOURCE_SUBDIR cpp
+)
+FetchContent_MakeAvailable(fory)
+
+add_executable(fory_example main.cc)
+target_link_libraries(fory_example PRIVATE fory::serialization)
+```
+
+```cpp title="main.cc"
+#include <cassert>
+#include <cstdint>
+#include <string>
+#include <utility>
+#include <vector>
+
+#include "fory/serialization/fory.h"
+
+struct User {
+  int64_t id;
+  std::string name;
+
+  bool operator==(const User &other) const {
+    return id == other.id && name == other.name;
+  }
+};
+FORY_STRUCT(User, id, name);
+
+int main() {
+  auto fory = fory::serialization::Fory::builder().xlang(true).build();
+  fory.register_struct<User>(1);
+
+  auto bytes = fory.serialize(User{1, "Alice"});
+  assert(bytes.ok());
+  std::vector<uint8_t> data = std::move(bytes).value();
+  auto decoded = fory.deserialize<User>(data);
+  assert(decoded.ok());
+  User user = std::move(decoded).value();
+  assert(user.id == 1 && user.name == "Alice");
+}
+```
+
+```bash
+cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+cmake --build build --parallel
+./build/fory_example
+```
+
+Bazel、Windows、错误处理和线程安全实例请参阅 [C++ 
对象序列化](../object-serialization/cpp/index.md);然后继续阅读 
[xlang](../object-serialization/cpp/xlang.md)或 [native 
模式](../object-serialization/cpp/native.md)。
+
+## 其他能力
+
+- **Row Format** 为可信分析数据提供随机和部分字段访问。请参阅 [C++ Row Format](../row-format/cpp.md)。
+- **Fory IDL 与编译器** 生成 C++ 
模型和注册辅助代码。请参阅[编译器快速入门](../compiler/getting-started.md)和 [C++ 
生成代码指南](../compiler/generated-code/cpp.md)。
+- **Fory gRPC** 通过 gRPC C++ 传输使用 Fory 编码的消息。请参阅 [C++ gRPC](../grpc/cpp.md)。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/csharp.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/csharp.md
index b70aebe209..1f5c9c03ce 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/csharp.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/csharp.md
@@ -1,5 +1,5 @@
 ---
-title: C# 环境配置
+title: C# 设置
 sidebar_position: 7
 id: csharp
 license: |
@@ -19,8 +19,7 @@ license: |
   limitations under the License.
 ---
 
-Fory C# 以 `Apache.Fory` 名称发布到 NuGet,需要 .NET 8 SDK 或更高版本。该包包含运行时和
-`ForyStruct` 类型的 source generator。一个应用的所有对等端应使用同一兼容的 Fory 发行版。
+Fory C# 提供 xlang 对象序列化、生成的模型以及 Fory gRPC。`Apache.Fory` NuGet 软件包需要 .NET 8 
或更高版本,其中同时包含运行时和源代码生成器。
 
 ## 验证工具链
 
@@ -28,12 +27,49 @@ Fory C# 以 `Apache.Fory` 名称发布到 NuGet,需要 .NET 8 SDK 或更高版
 dotnet --version
 ```
 
-## 选择能力
+## 对象序列化
 
-| 能力              | 软件包或工具                    | 后续文档                           
                                                                         |
-| ----------------- | ------------------------------- | 
-----------------------------------------------------------------------------------------------------------
 |
-| 对象序列化        | `Apache.Fory`                   | [C# 
对象序列化](../object-serialization/csharp/index.md)和 
[xlang](../object-serialization/csharp/xlang.md) |
-| Schema 和生成模型 | `fory-compiler`                 | [Fory IDL 
和编译器](../compiler/index.md)                                                     
              |
-| Fory gRPC         | 生成的配套代码加 gRPC .NET 依赖 | [C# gRPC](../grpc/csharp.md)     
                                                                           |
+创建控制台项目并添加已发布的软件包:
 
-每个能力指南都会提供确切的软件包声明和首个可运行示例。
+```bash
+dotnet new console -n ForyExample
+cd ForyExample
+dotnet add package Apache.Fory --version 1.5.0
+```
+
+将 `Program.cs` 替换为:
+
+```csharp
+using Apache.Fory;
+
+[ForyStruct]
+public sealed class User
+{
+    public long Id { get; set; }
+    public string Name { get; set; } = string.Empty;
+}
+
+public static class Program
+{
+    public static void Main()
+    {
+        Fory fory = Fory.Builder().Build();
+        fory.Register<User>(1);
+
+        byte[] bytes = fory.Serialize(new User { Id = 1, Name = "Alice" });
+        User decoded = fory.Deserialize<User>(bytes);
+        Console.WriteLine(decoded.Name);
+    }
+}
+```
+
+```bash
+dotnet run
+```
+
+C# 使用 xlang 模式。接下来可阅读 [C# 
对象序列化](../object-serialization/csharp/index.md)、[xlang 
类型](../object-serialization/csharp/xlang.md)、[配置](../object-serialization/csharp/configuration.md)和
 [Schema 演进](../object-serialization/csharp/schema-evolution.md)。
+
+## 其他能力
+
+- **Fory IDL 与编译器** 生成 C# 
模型和注册辅助代码。请参阅[编译器快速入门](../compiler/getting-started.md)和 [C# 
生成代码指南](../compiler/generated-code/csharp.md)。
+- **Fory gRPC** 通过常规 .NET gRPC 传输使用 Fory 编码的消息。请参阅 [C# 
gRPC](../grpc/csharp.md)。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/dart.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/dart.md
index 75738918a8..4f2bb0c17e 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/dart.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/dart.md
@@ -1,5 +1,5 @@
 ---
-title: Dart 环境配置
+title: Dart 设置
 sidebar_position: 9
 id: dart
 license: |
@@ -19,8 +19,7 @@ license: |
   limitations under the License.
 ---
 
-Fory Dart 发布在 pub.dev,需要 Dart SDK 3.7 或更高版本。生成序列化器使用 `build_runner`。
-一个应用中的 Fory 软件包和生成代码应保持版本兼容。
+Fory Dart 提供 xlang 对象序列化、生成的模型以及 Fory gRPC。它发布在 pub.dev,需要 Dart 3.7 或更高版本,并使用 
`build_runner` 生成序列化器。
 
 ## 验证工具链
 
@@ -29,12 +28,58 @@ dart --version
 dart pub --help
 ```
 
-## 选择能力
+## 对象序列化
 
-| 能力              | 软件包或工具                    | 后续文档                           
                                                                       |
-| ----------------- | ------------------------------- | 
---------------------------------------------------------------------------------------------------------
 |
-| 对象序列化        | `fory` 加 `build_runner`        | [Dart 
对象序列化](../object-serialization/dart/index.md)和 
[xlang](../object-serialization/dart/xlang.md) |
-| Schema 和生成模型 | `fory-compiler`                 | [Fory IDL 
和编译器](../compiler/index.md)                                                     
            |
-| Fory gRPC         | 生成的配套代码加 `package:grpc` | [Dart gRPC](../grpc/dart.md)   
                                                                           |
+在 `pubspec.yaml` 中添加 Fory 和生成器:
 
-每个能力指南都会提供确切的 `pubspec.yaml`、生成命令和首个可运行示例。
+```yaml
+dependencies:
+  fory: 1.5.0
+
+dev_dependencies:
+  build_runner: ^2.4.0
+```
+
+创建 `lib/person.dart`:
+
+```dart
+import 'package:fory/fory.dart';
+
+part 'person.fory.dart';
+
+@ForyStruct()
+class Person {
+  Person();
+
+  @ForyField(type: Int64Type())
+  int id = 0;
+  String name = '';
+}
+
+void main() {
+  final fory = Fory();
+  PersonForyModule.register(fory, Person, name: 'example.Person');
+
+  final input = Person()
+    ..id = 1
+    ..name = 'Alice';
+  final bytes = fory.serialize(input);
+  final decoded = fory.deserialize<Person>(bytes);
+  print(decoded.name);
+}
+```
+
+生成序列化器并运行示例:
+
+```bash
+dart pub get
+dart run build_runner build
+dart run lib/person.dart
+```
+
+Dart 使用 xlang 模式。接下来可阅读 [Dart 
对象序列化](../object-serialization/dart/index.md)、[代码生成](../object-serialization/dart/code-generation.md)、[Web
 支持](../object-serialization/dart/web-platform-support.md)和 [Schema 
演进](../object-serialization/dart/schema-evolution.md)。
+
+## 其他能力
+
+- **Fory IDL 与编译器** 生成 Dart 
模型和注册辅助代码。请参阅[编译器快速入门](../compiler/getting-started.md)和 [Dart 
生成代码指南](../compiler/generated-code/dart.md)。
+- **Fory gRPC** 通过 package:grpc 传输使用 Fory 编码的消息。请参阅 [Dart 
gRPC](../grpc/dart.md)。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/go.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/go.md
index d09d2b888c..a07aca9dc8 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/go.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/go.md
@@ -1,5 +1,5 @@
 ---
-title: Go 环境配置
+title: Go 设置
 sidebar_position: 4
 id: go
 license: |
@@ -19,8 +19,7 @@ license: |
   limitations under the License.
 ---
 
-Fory Go 以 Go module `github.com/apache/fory/go/fory` 发布,需要 Go 1.24 或更高版本。一个
-应用的所有对等端应使用同一兼容的 Fory 发行版。
+Fory Go 提供 xlang 和 native 对象序列化、生成的模型以及 Fory gRPC。它以 
`github.com/apache/fory/go/fory` 发布,需要 Go 1.25 或更高版本。
 
 ## 验证工具链
 
@@ -29,14 +28,59 @@ go version
 go env GOPROXY
 ```
 
-如果 Go proxy 尚未获取新的 submodule tag,请稍后重试,或暂时使用 `GOPROXY=direct`。
+## 对象序列化
 
-## 选择能力
+创建 module 并安装已发布的 Fory module:
 
-| 能力              | Module 或工具                    | 后续文档                       
                                                                                
                                               |
-| ----------------- | -------------------------------- | 
-------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| 对象序列化        | `github.com/apache/fory/go/fory` | [Go 
对象序列化](../object-serialization/go/index.md),然后选择 
[xlang](../object-serialization/go/xlang.md) 或 
[native](../object-serialization/go/native.md) |
-| Schema 和生成模型 | `fory-compiler`                  | [Fory IDL 
和编译器](../compiler/index.md)                                                     
                                                                |
-| Fory gRPC         | 生成的配套代码加 grpc-go         | [Go gRPC](../grpc/go.md)      
                                                                                
                                                |
+```bash
+mkdir fory-example
+cd fory-example
+go mod init example.com/fory-example
+go get github.com/apache/fory/go/[email protected]
+```
+
+如果 Go proxy 尚未收录新的 submodule tag,请稍后重试,或者暂时使用 `GOPROXY=direct`。
+
+```go title="main.go"
+package main
+
+import (
+    "fmt"
+
+    "github.com/apache/fory/go/fory"
+)
+
+type User struct {
+    ID   int64
+    Name string
+}
+
+func main() {
+    f := fory.New(fory.WithXlang(true))
+    if err := f.RegisterStruct(User{}, 1); err != nil {
+        panic(err)
+    }
+
+    bytes, err := f.Serialize(&User{ID: 1, Name: "Alice"})
+    if err != nil {
+        panic(err)
+    }
+
+    var decoded User
+    if err := f.Deserialize(bytes, &decoded); err != nil {
+        panic(err)
+    }
+    fmt.Println(decoded.Name)
+}
+```
+
+```bash
+go run .
+```
+
+跨语言数据请使用 [xlang 模式](../object-serialization/go/xlang.md),仅供 Go 使用的数据请使用 
[native 模式](../object-serialization/go/native.md)。接下来可阅读 [Go 
对象序列化](../object-serialization/go/index.md)、[配置](../object-serialization/go/configuration.md)和
 [Schema 演进](../object-serialization/go/schema-evolution.md)。
+
+## 其他能力
 
-每个能力指南都会提供确切的 module 命令和首个可运行示例。
+- **Fory IDL 与编译器** 生成 Go 
模型和注册辅助代码。请参阅[编译器快速入门](../compiler/getting-started.md)和 [Go 
生成代码指南](../compiler/generated-code/go.md)。
+- **Fory gRPC** 通过 grpc-go 传输使用 Fory 编码的消息。请参阅 [Go gRPC](../grpc/go.md)。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/index.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/index.md
index 00f77c95ef..62737cd51b 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/index.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/index.md
@@ -1,5 +1,5 @@
 ---
-title: 快速开始
+title: 快速入门
 sidebar_position: 0
 id: index
 license: |
@@ -19,15 +19,23 @@ license: |
   limitations under the License.
 ---
 
-Apache Fory™ 发行版同时提供源代码制品和特定语言的软件包。
+从下面的运行时页面开始。每个页面都提供锁定到具体发行版本的安装方式、可运行的对象序列化往返示例、该运行时支持的模式,以及通往其他可用 Fory 
能力的简要入口。
 
-如需下载源代码,请访问 Apache Fory™ [下载](https://fory.apache.org/download)页面。
+Apache Fory™ 以源代码制品和各语言专用软件包的形式发布。若要下载源代码,请访问 Apache Fory™ 
[下载](https://fory.apache.org/download)页面。
+
+## 五分钟上手
+
+1. 选择应用使用的运行时。
+2. 安装该运行时页面中列出的软件包。
+3. 运行最小序列化/反序列化示例。
+4. 如果两种模式都可用,跨语言数据选择 xlang 模式,同一运行时的数据选择 native 模式。
+5. 前往对应能力指南,了解生产环境配置和高级 API。
 
 ## 选择运行时
 
-每个运行时的环境配置页面都会检查工具链,并引导你前往该运行时支持的能力:
+每个运行时页面都提供锁定到具体发行版本的安装片段、适用于应用项目的最小往返示例,以及后续能力专项步骤:
 
-| 运行时                | 环境配置                               |
+| 运行时                | 设置                                   |
 | --------------------- | -------------------------------------- |
 | Java                  | [Java](java.md)                        |
 | Python                | [Python](python.md)                    |
@@ -41,19 +49,14 @@ Apache Fory™ 发行版同时提供源代码制品和特定语言的软件包
 | Scala                 | [Scala](scala.md)                      |
 | Kotlin                | [Kotlin](kotlin.md)                    |
 
-## 选择能力
-
-| 需求                   | 后续文档                                       |
-| ---------------------- | ---------------------------------------------- |
-| 重建对象图             | [对象序列化](../object-serialization/index.md) |
-| 随机或部分访问分析数据 | [Row Format](../row-format/index.md)           |
-| 从 Java 交换标准 JSON  | [Fory JSON](../json/index.md)                  |
-| 根据 Schema 生成模型   | [Fory IDL 和编译器](../compiler/index.md)      |
-| 通过 gRPC 使用生成模型 | [Fory gRPC](../grpc/index.md)                  |
+## 可以构建什么
 
-对象序列化随后要求你在两种模式中选择:可移植跨语言载荷使用 xlang 模式,同运行时载荷使用
-native 模式。如果尚不清楚应选择哪种产品,请参阅
-[选择格式](../introduction/choose-a-format.md)。
+| 能力       | 用途                                                        | 可用运行时 
                                                        | 详细指南                  
                               |
+| ---------- | ----------------------------------------------------------- | 
------------------------------------------------------------------ | 
-------------------------------------------------------- |
+| 对象序列化 | 重建对象图,包括共享引用和 Schema 变更                      | 所有运行时                 
                                        | 
[对象序列化](../object-serialization/index.md)            |
+| Row Format | 对可信分析数据进行零拷贝、随机或部分字段访问                | Java、Python、C++、Rust    
                                        | [Row Format](../row-format/index.md)  
                   |
+| Fory JSON  | 高性能标准 JSON 映射                                        | Java     
                                                          | [Fory 
JSON](../json/index.md)                            |
+| Fory IDL   | 从 Fory、protobuf 或 FlatBuffers IDL 生成原生模型和序列化器 | 所有运行时           
                                              | [Fory IDL 
与编译器](../compiler/index.md)                |
+| Fory gRPC  | 通过常规 gRPC 传输使用生成的模型和 Fory 编码的消息          | 
Java、Python、C++、Go、Rust、JavaScript、C#、Dart、Scala、Kotlin | [Fory 
gRPC](../grpc/index.md)                            |
 
-所选能力指南会提供确切依赖和首个可成功运行的任务。Schema 兼容性设置和生产配置取决于
-具体运行时。
+对象序列化使用 xlang 模式生成可移植的跨语言数据。Java、Python、C++、Go、Rust、Scala 和 Kotlin 还提供 native 
模式,用于同一运行时内的数据。如果尚未明确产品应选择哪种格式,请参阅[选择格式](../introduction/choose-a-format.md)。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/java.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/java.md
index 3354be0870..fc5c066eea 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/java.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/java.md
@@ -1,5 +1,5 @@
 ---
-title: Java 环境配置
+title: Java 设置
 sidebar_position: 1
 id: java
 license: |
@@ -19,9 +19,7 @@ license: |
   limitations under the License.
 ---
 
-Fory Java 制品发布到 Maven Central。Fory core 支持 Java 8 及更高版本;Java Record 需要
-Java 17 或更高版本,Row Format 需要 Java 11 或更高版本。一个应用中的所有 Fory 制品应
-使用相同版本。
+Fory Java 提供二进制对象序列化、Fory JSON、Row Format、生成的模型和 Fory gRPC。相关制品发布在 Maven 
Central。Fory core 和 Fory JSON 支持 Java 8 及更高版本,Java Record 需要 Java 17 及更高版本,Row 
Format 需要 Java 11 及更高版本。同一应用中的所有 Fory 制品应使用相同版本。
 
 ## 验证工具链
 
@@ -31,14 +29,90 @@ mvn -version
 # or: ./gradlew --version
 ```
 
-## 选择能力
+## 对象序列化
 
-| 能力              | 制品或工具                      | 后续文档                          
                                                                                
                                                    |
-| ----------------- | ------------------------------- | 
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| 对象序列化        | `fory-core`                     | [Java 
对象序列化](../object-serialization/java/index.md),然后选择 
[xlang](../object-serialization/java/xlang.md) 或 
[native](../object-serialization/java/native.md) |
-| Fory JSON         | `fory-json`                     | [Fory JSON 
快速开始](../json/getting-started.md)                                               
                                                                       |
-| Row Format        | `fory-format`                   | [Java Row 
Format](../row-format/java.md)                                                  
                                                                            |
-| Schema 和生成模型 | `fory-compiler`                 | [Fory IDL 
和编译器](../compiler/index.md)                                                     
                                                                        |
-| Fory gRPC         | 生成的配套代码加 gRPC Java 依赖 | [Java gRPC](../grpc/java.md)     
                                                                                
                                                     |
+使用对象序列化处理对象图。Xlang 模式生成的数据可由其他 Fory 运行时读取;native 模式支持范围更广的 JVM 对象。
 
-每个能力指南都会提供确切的依赖声明和首个可运行示例。
+Maven:
+
+```xml
+<dependency>
+  <groupId>org.apache.fory</groupId>
+  <artifactId>fory-core</artifactId>
+  <version>1.5.0</version>
+</dependency>
+```
+
+Gradle:
+
+```kotlin
+implementation("org.apache.fory:fory-core:1.5.0")
+```
+
+运行下面完整的 xlang 往返示例:
+
+```java
+import org.apache.fory.Fory;
+
+public final class ForyExample {
+  public static final class User {
+    public long id;
+    public String name;
+
+    public User() {}
+
+    public User(long id, String name) {
+      this.id = id;
+      this.name = name;
+    }
+  }
+
+  public static void main(String[] args) {
+    Fory fory = Fory.builder().withXlang(true).build();
+    fory.register(User.class, 1);
+
+    byte[] bytes = fory.serialize(new User(1, "Alice"));
+    User decoded = (User) fory.deserialize(bytes);
+    System.out.println(decoded.name);
+  }
+}
+```
+
+请复用 `Fory` 实例,不要为每个值重新创建实例。接下来可阅读 [Java 
对象序列化](../object-serialization/java/index.md)、[xlang 
模式](../object-serialization/java/xlang.md)、[native 
模式](../object-serialization/java/native.md)或[配置](../object-serialization/java/configuration.md)。
+
+## Fory JSON
+
+Fory JSON 将 Java 对象映射为标准 JSON 文本和 UTF-8 字节。如果应用只需要 JSON,请添加 `fory-json`,无需添加 
`fory-core`:
+
+```kotlin
+implementation("org.apache.fory:fory-json:1.5.0")
+```
+
+在 `ForyExample.java` 中添加 import:
+
+```java
+import org.apache.fory.json.ForyJson;
+```
+
+然后将 JSON 往返代码放入 `ForyExample.main`:
+
+```java
+ForyJson json = ForyJson.builder().build();
+String text = json.toJson(new User(1, "Alice"));
+User jsonDecoded = json.fromJson(text, User.class);
+System.out.println(jsonDecoded.name);
+```
+
+Maven 设置、对象映射、注解、Android、GraalVM 和安全相关内容请参阅 [Fory JSON 
快速入门](../json/getting-started.md)。
+
+## 其他能力
+
+- **Row Format** 为可信分析数据提供随机和部分字段访问。请参阅 [Java Row 
Format](../row-format/java.md)。
+- **Fory IDL 与编译器** 从 Fory IDL、protobuf IDL 或 FlatBuffers IDL 生成 Java 
模型和注册辅助代码。请参阅[编译器快速入门](../compiler/getting-started.md)和 [Java 
生成代码指南](../compiler/generated-code/java.md)。
+- **Fory gRPC** 通过常规 grpc-java 传输使用 Fory 编码的请求与响应对象。请参阅 [Java 
gRPC](../grpc/java.md)。
+
+## 运行时说明
+
+- 在 JDK 25 及更高版本上,请按照 [Java 
对象序列化](../object-serialization/java/index.md)中的设置操作。
+- Android 请参阅 [Java Android 支持](../object-serialization/java/android.md)。
+- 原生镜像请参阅 [Java GraalVM 支持](../object-serialization/java/graalvm.md)。
diff --git 
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/javascript.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/javascript.md
index 14003f2c33..ec9f0661a3 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/javascript.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/javascript.md
@@ -1,5 +1,5 @@
 ---
-title: JavaScript/TypeScript 环境配置
+title: JavaScript/TypeScript 设置
 sidebar_position: 6
 id: javascript
 license: |
@@ -19,9 +19,7 @@ license: |
   limitations under the License.
 ---
 
-Fory JavaScript/TypeScript 软件包发布在 npm。core 包无需原生加速即可工作;可选的
-`@apache-fory/hps` Node.js 快速路径需要 Node.js 20 或更高版本。一个应用中的 Fory 软件包
-应保持版本兼容。
+Fory JavaScript/TypeScript 提供 xlang 对象序列化、生成的模型、Node.js gRPC 以及浏览器 gRPC-Web 
客户端。相关软件包发布在 npm。core 软件包无需原生加速即可工作;可选的 `@apache-fory/hps` Node.js 快速路径需要 
Node.js 20 或更高版本。
 
 ## 验证工具链
 
@@ -30,12 +28,47 @@ node --version
 npm --version
 ```
 
-## 选择能力
+## 对象序列化
 
-| 能力              | 软件包或工具                                 | 后续文档              
                                                                                
                                 |
-| ----------------- | -------------------------------------------- | 
--------------------------------------------------------------------------------------------------------------------------------------
 |
-| 对象序列化        | `@apache-fory/core`;可选 `@apache-fory/hps` | 
[JavaScript/TypeScript 对象序列化](../object-serialization/javascript/index.md)和 
[xlang](../object-serialization/javascript/xlang.md) |
-| Schema 和生成模型 | `fory-compiler`                              | [Fory IDL 
和编译器](../compiler/index.md)                                                     
                                         |
-| Fory gRPC         | 生成的 Node.js 或 gRPC-Web 配套代码          | [JavaScript 
gRPC](../grpc/javascript.md)                                                    
                                           |
+安装 core 软件包:
 
-每个能力指南都会提供确切的安装命令、环境特定配置和首个可运行示例。
+```bash
+npm install @apache-fory/[email protected]
+```
+
+定义 Schema 并运行 xlang 往返示例:
+
+```js title="example.mjs"
+import Fory, { Type } from "@apache-fory/core";
+
+const userType = Type.struct(
+  { typeName: "example.User" },
+  {
+    id: Type.int64(),
+    name: Type.string(),
+  },
+);
+
+const fory = new Fory();
+const { serialize, deserialize } = fory.register(userType);
+
+const bytes = serialize({ id: 1n, name: "Alice" });
+console.log(deserialize(bytes));
+```
+
+```bash
+node example.mjs
+```
+
+JavaScript 使用 xlang 模式。接下来可阅读 [JavaScript/TypeScript 
对象序列化](../object-serialization/javascript/index.md)、[xlang 
类型](../object-serialization/javascript/xlang.md)、[配置](../object-serialization/javascript/configuration.md)和
 [Schema 演进](../object-serialization/javascript/schema-evolution.md)。
+
+若要使用可选的 Node.js 字符串快速路径,请安装版本匹配的软件包:
+
+```bash
+npm install @apache-fory/[email protected] @apache-fory/[email protected]
+```
+
+## 其他能力
+
+- **Fory IDL 与编译器** 生成 TypeScript 接口、Schema 
和注册辅助代码。请参阅[编译器快速入门](../compiler/getting-started.md)和 [JavaScript 
生成代码指南](../compiler/generated-code/javascript.md)。
+- **Fory gRPC** 支持通过 Node.js gRPC 和浏览器 gRPC-Web 传输使用 Fory 编码的消息。请参阅 
[JavaScript gRPC](../grpc/javascript.md)。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/kotlin.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/kotlin.md
index c07dfea192..a823b4be5f 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/kotlin.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/kotlin.md
@@ -1,5 +1,5 @@
 ---
-title: Kotlin 环境配置
+title: Kotlin 设置
 sidebar_position: 11
 id: kotlin
 license: |
@@ -19,8 +19,7 @@ license: |
   limitations under the License.
 ---
 
-Fory Kotlin 制品发布到 Maven Central,并运行在 Fory Java 之上。Fory core 支持 Java 8 及
-更高版本。一个应用中的 Kotlin、Java core 和生成代码制品应使用同一 Fory 发行版。
+Fory Kotlin 提供二进制对象序列化、生成的模型、Fory gRPC 和 Android 支持。它基于 Fory Java 运行,支持 Java 8 
及更高版本。
 
 ## 验证工具链
 
@@ -30,13 +29,47 @@ java -version
 # or: mvn -version
 ```
 
-## 选择能力
+## 对象序列化
 
-| 能力               | 制品或工具                              | 后续文档                 
                                                                                
                                                                     |
-| ------------------ | --------------------------------------- | 
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| 对象序列化         | `fory-kotlin`                           | [Kotlin 
对象序列化](../object-serialization/kotlin/index.md),然后选择 
[xlang](../object-serialization/kotlin/xlang.md) 或 
[native](../object-serialization/kotlin/native.md) |
-| Schema 和生成模型  | `fory-compiler` 和 Kotlin KSP 支持      | [Fory IDL 
和编译器](../compiler/index.md)                                                     
                                                                                
|
-| Fory gRPC          | 生成的 coroutine 配套代码加 grpc-kotlin | [Kotlin 
gRPC](../grpc/kotlin.md)                                                        
                                                                                
      |
-| Android 对象序列化 | `fory-kotlin` 加生成序列化器            | 
[Android](../object-serialization/java/android.md)                              
                                                                                
              |
+在应用模块中添加运行时:
 
-每个能力指南都会提供确切的 Maven 或 Gradle 声明和首个可运行示例。
+```kotlin title="build.gradle.kts"
+dependencies {
+  implementation("org.apache.fory:fory-kotlin:1.5.0")
+}
+```
+
+创建 `src/main/kotlin/KotlinExample.kt`:
+
+```kotlin
+import org.apache.fory.ThreadSafeFory
+import org.apache.fory.kotlin.ForyKotlin
+
+data class User(val id: Long, val name: String)
+
+fun main() {
+    val fory: ThreadSafeFory = ForyKotlin.builder()
+        .withXlang(true)
+        .requireClassRegistration(true)
+        .buildThreadSafeFory()
+    fory.register(User::class.java, 1)
+
+    val bytes = fory.serialize(User(1, "Alice"))
+    val decoded = fory.deserialize(bytes) as User
+    println(decoded.name)
+}
+```
+
+如果项目应用了 Gradle 的 `application` 插件,请运行对应的应用任务:
+
+```bash
+./gradlew run
+```
+
+与其他 Fory 运行时共享的数据使用 xlang 模式,仅供 Kotlin/JVM 使用的数据使用 native 模式。接下来可阅读 [Kotlin 
对象序列化](../object-serialization/kotlin/index.md)、[xlang](../object-serialization/kotlin/xlang.md)或
 [native 模式](../object-serialization/kotlin/native.md)。
+
+## 其他能力
+
+- **Fory IDL 与编译器** 通过 KSP 生成 Kotlin 
模型和注册辅助代码。请参阅[编译器快速入门](../compiler/getting-started.md)和 [Kotlin 
生成代码指南](../compiler/generated-code/kotlin.md)。
+- **Fory gRPC** 通过 grpc-kotlin 和 grpc-java 传输使用 Fory 编码的消息。请参阅 [Kotlin 
gRPC](../grpc/kotlin.md)。
+- **Android** 使用生成的序列化器和同一个 Fory Kotlin 运行时。请参阅 [Android 
对象序列化](../object-serialization/java/android.md)。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/python.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/python.md
index 9382adfd52..5d16c6b6fb 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/python.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/python.md
@@ -1,5 +1,5 @@
 ---
-title: Python 环境配置
+title: Python 设置
 sidebar_position: 2
 id: python
 license: |
@@ -19,8 +19,7 @@ license: |
   limitations under the License.
 ---
 
-Python 软件包发布在 PyPI。`pyfory` 在 Linux、macOS 和 Windows 上支持 Python 3.8 及更高
-版本。一个应用的所有对等端应使用同一兼容的 Fory 发行版。
+`pyfory` 提供二进制对象序列化和 Row Format。Fory IDL 还可以生成 Python 模型和 gRPC 配套代码。该软件包在 
Linux、macOS 和 Windows 上支持 Python 3.8 及更高版本。
 
 ## 验证工具链
 
@@ -29,13 +28,40 @@ python --version
 python -m pip --version
 ```
 
-## 选择能力
+## 对象序列化
 
-| 能力              | 软件包或 extra       | 后续文档                                    
                                                                                
                                                  |
-| ----------------- | -------------------- | 
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| 对象序列化        | `pyfory`             | [Python 
对象序列化](../object-serialization/python/index.md),然后选择 
[xlang](../object-serialization/python/xlang.md) 或 
[native](../object-serialization/python/native.md) |
-| Row Format        | `pyfory[format]`     | [Python Row 
Format](../row-format/python.md)                                                
                                                                                
  |
-| Schema 和生成模型 | `fory-compiler`      | [Fory IDL 和编译器](../compiler/index.md)  
                                                                                
                                                   |
-| Fory gRPC         | `pyfory` 加 `grpcio` | [Python gRPC](../grpc/python.md)   
                                                                                
                                                           |
+安装已发布的软件包:
 
-每个能力指南都会提供确切的安装命令和首个可运行示例。
+```bash
+python -m pip install pyfory==1.5.0
+```
+
+运行 xlang 往返示例:
+
+```python
+from dataclasses import dataclass
+
+import pyfory
+
+
+@dataclass
+class User:
+    name: str
+    age: pyfory.Int32
+
+
+fory = pyfory.Fory(xlang=True, ref=True)
+fory.register(User, type_id=1)
+
+data = fory.serialize(User("Alice", 30))
+decoded = fory.deserialize(data)
+print(decoded)
+```
+
+跨语言数据请使用 [xlang 模式](../object-serialization/python/xlang.md)。仅供 Python 
使用的对象(包括 Python 可调用对象和序列化钩子)请使用 [native 
模式](../object-serialization/python/native.md)。接下来可阅读 [Python 
指南](../object-serialization/python/index.md)、[配置](../object-serialization/python/configuration.md)和[类型注册](../object-serialization/python/type-registration.md)。
+
+## 其他能力
+
+- **Row Format** 为可信分析数据提供零拷贝字段访问。请参阅 [Python Row 
Format](../row-format/python.md)。
+- **Fory IDL 与编译器** 生成 Python 
模型和注册辅助代码。请参阅[编译器快速入门](../compiler/getting-started.md)和 [Python 
生成代码指南](../compiler/generated-code/python.md)。
+- **Fory gRPC** 通过 grpcio 传输使用 Fory 编码的消息。请参阅 [Python gRPC](../grpc/python.md)。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/rust.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/rust.md
index 3c96711428..8378febbfc 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/rust.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/rust.md
@@ -1,5 +1,5 @@
 ---
-title: Rust 环境配置
+title: Rust 设置
 sidebar_position: 5
 id: rust
 license: |
@@ -19,8 +19,7 @@ license: |
   limitations under the License.
 ---
 
-Fory Rust 发布在 crates.io。workspace 支持的最低 Rust 版本为 1.70,并使用 Rust 2021 edition。
-一个应用的所有对等端应使用同一兼容的 Fory 发行版。
+Fory Rust 提供 xlang 和 native 对象序列化、标准 Row Format、生成的模型以及 Fory gRPC。公开的 `fory` 
crate 发布在 crates.io,支持 Rust 1.70 及更高版本,并使用 Rust 2021 edition。
 
 ## 验证工具链
 
@@ -29,13 +28,43 @@ rustc --version
 cargo --version
 ```
 
-## 选择能力
+## 对象序列化
 
-| 能力                | Crate 或工具                        | 后续文档                  
                                                                                
                                                            |
-| ------------------- | ----------------------------------- | 
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| 对象序列化          | `fory`                              | [Rust 
对象序列化](../object-serialization/rust/index.md),然后选择 
[xlang](../object-serialization/rust/xlang.md) 或 
[native](../object-serialization/rust/native.md) |
-| Standard Row Format | `fory`                              | [Rust Row 
Format](../row-format/rust.md)                                                  
                                                                            |
-| Schema 和生成模型   | `fory-compiler`                     | [Fory IDL 
和编译器](../compiler/index.md)                                                     
                                                                        |
-| Fory gRPC           | 生成的配套代码加 `tonic` 和 `bytes` | [Rust 
gRPC](../grpc/rust.md)                                                          
                                                                                
|
+添加公开 crate:
 
-每个能力指南都会提供确切的依赖声明和首个可运行示例。
+```toml title="Cargo.toml"
+[dependencies]
+fory = "1.5.0"
+```
+
+```rust
+use fory::{Error, Fory, ForyStruct};
+
+#[derive(ForyStruct, Debug, PartialEq)]
+struct User {
+    id: i64,
+    name: String,
+}
+
+fn main() -> Result<(), Error> {
+    let mut fory = Fory::builder().xlang(true).build();
+    fory.register::<User>(1)?;
+
+    let user = User {
+        id: 1,
+        name: "Alice".to_string(),
+    };
+    let bytes = fory.serialize(&user)?;
+    let decoded: User = fory.deserialize(&bytes)?;
+    assert_eq!(user, decoded);
+    Ok(())
+}
+```
+
+跨语言数据请使用 [xlang 模式](../object-serialization/rust/xlang.md),仅供 Rust 使用的数据请使用 
[native 模式](../object-serialization/rust/native.md)。接下来可阅读 [Rust 
对象序列化](../object-serialization/rust/index.md)、[配置](../object-serialization/rust/configuration.md)和[类型注册](../object-serialization/rust/type-registration.md)。
+
+## 其他能力
+
+- **Row Format** 使用标准 Fory Row 布局,为可信分析数据提供零拷贝视图。请参阅 [Rust Row 
Format](../row-format/rust.md)。
+- **Fory IDL 与编译器** 生成 Rust 
模型和注册辅助代码。请参阅[编译器快速入门](../compiler/getting-started.md)和 [Rust 
生成代码指南](../compiler/generated-code/rust.md)。
+- **Fory gRPC** 通过 tonic 传输使用 Fory 编码的消息。请参阅 [Rust gRPC](../grpc/rust.md)。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/scala.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/scala.md
index 1162fbd0f0..c1067aa823 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/scala.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/scala.md
@@ -1,5 +1,5 @@
 ---
-title: Scala 环境配置
+title: Scala 设置
 sidebar_position: 10
 id: scala
 license: |
@@ -19,9 +19,7 @@ license: |
   limitations under the License.
 ---
 
-Fory Scala 为 Scala 2.13 和 Scala 3 发布制品到 Maven Central。由 Schema 生成的 Scala 源代码
-和宏派生的 xlang 序列化器需要 Scala 3。运行时使用 Fory Java,因此所有 Fory 制品应保持
-在同一发行版。
+Fory Scala 提供二进制对象序列化、生成的模型以及 Fory gRPC。运行时制品支持 Scala 2.13 和 Scala 3;生成的 Scala 
模型需要 Scala 3。
 
 ## 验证工具链
 
@@ -31,12 +29,44 @@ scala -version
 sbt --version
 ```
 
-## 选择能力
+## 对象序列化
 
-| 能力              | 制品或工具                          | 后续文档                      
                                                                                
                                                            |
-| ----------------- | ----------------------------------- | 
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| 对象序列化        | `fory-scala_2.13` 或 `fory-scala_3` | [Scala 
对象序列化](../object-serialization/scala/index.md),然后选择 
[xlang](../object-serialization/scala/xlang.md) 或 
[native](../object-serialization/scala/native.md) |
-| Schema 和生成模型 | `fory-compiler`;Scala 3 输出       | [Fory IDL 
和编译器](../compiler/index.md)                                                     
                                                                            |
-| Fory gRPC         | Scala 3 生成配套代码加 grpc-java    | [Scala 
gRPC](../grpc/scala.md)                                                         
                                                                                
   |
+在 `build.sbt` 中添加运行时:
 
-每个能力指南都会提供确切的 Maven 或 sbt 声明和首个可运行示例。
+```sbt
+ThisBuild / scalaVersion := "3.3.1"
+libraryDependencies += "org.apache.fory" %% "fory-scala" % "1.5.0"
+```
+
+创建 `src/main/scala/ScalaExample.scala`:
+
+```scala
+import org.apache.fory.Fory
+import org.apache.fory.scala.ForyScala
+
+case class User(id: Long, name: String)
+
+object ScalaExample {
+  def main(args: Array[String]): Unit = {
+    val fory: Fory = ForyScala.builder()
+      .withXlang(true)
+      .build()
+    fory.register(classOf[User], 1)
+
+    val bytes = fory.serialize(User(1, "Alice"))
+    val decoded = fory.deserialize(bytes).asInstanceOf[User]
+    println(decoded.name)
+  }
+}
+```
+
+```bash
+sbt run
+```
+
+与其他 Fory 运行时共享的数据使用 xlang 模式,仅供 Scala/JVM 使用的数据使用 native 模式。接下来可阅读 [Scala 
对象序列化](../object-serialization/scala/index.md)、[xlang](../object-serialization/scala/xlang.md)或
 [native 模式](../object-serialization/scala/native.md)。
+
+## 其他能力
+
+- **Fory IDL 与编译器** 生成 Scala 3 
模型和注册辅助代码。请参阅[编译器快速入门](../compiler/getting-started.md)和 [Scala 
生成代码指南](../compiler/generated-code/scala.md)。
+- **Fory gRPC** 通过 grpc-java 传输使用 Fory 编码的消息。请参阅 [Scala 
gRPC](../grpc/scala.md)。
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/swift.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/swift.md
index 7e0a1ad3a3..96653fe49e 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/swift.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/start/swift.md
@@ -1,5 +1,5 @@
 ---
-title: Swift 环境配置
+title: Swift 设置
 sidebar_position: 8
 id: swift
 license: |
@@ -19,9 +19,7 @@ license: |
   limitations under the License.
 ---
 
-Fory Swift 通过 Swift Package Manager 从 Apache Fory 仓库分发。当前软件包使用 Swift tools
-6.0,目标平台为 macOS 13 或更高版本以及 iOS 16 或更高版本。一个应用的所有对等端应固定
-使用同一 Fory 发行版。
+Fory Swift 提供 xlang 对象序列化和编译器生成的模型。它通过 Swift Package Manager 分发,使用 Swift tools 
6.0,目标平台为 macOS 13 及更高版本和 iOS 16 及更高版本。
 
 ## 验证工具链
 
@@ -29,11 +27,54 @@ Fory Swift 通过 Swift Package Manager 从 Apache Fory 仓库分发。当前软
 swift --version
 ```
 
-## 选择能力
+## 对象序列化
 
-| 能力              | 软件包 product 或工具        | 后续文档                              
                                                                       |
-| ----------------- | ---------------------------- | 
------------------------------------------------------------------------------------------------------------
 |
-| 对象序列化        | Swift package product `Fory` | [Swift 
对象序列化](../object-serialization/swift/index.md)和 
[xlang](../object-serialization/swift/xlang.md) |
-| Schema 和生成模型 | `fory-compiler`              | [Fory IDL 
和编译器](../compiler/index.md)                                                     
               |
+创建可执行软件包:
 
-所选能力指南会提供确切的软件包声明和首个可运行示例。
+```bash
+swift package init --type executable --name ForyExample
+```
+
+在生成的 `Package.swift` 中添加已发布的软件包和 `Fory` 产品:
+
+```swift title="Package.swift"
+dependencies: [
+    .package(url: "https://github.com/apache/fory.git";, exact: "1.5.0")
+],
+targets: [
+    .executableTarget(
+        name: "ForyExample",
+        dependencies: [.product(name: "Fory", package: "fory")]
+    )
+]
+```
+
+将 `Sources/main.swift` 替换为:
+
+```swift title="Sources/main.swift"
+import Fory
+
+@ForyStruct
+struct User: Equatable {
+    var id: Int64 = 0
+    var name: String = ""
+}
+
+let fory = Fory()
+try fory.register(User.self, id: 1)
+
+let input = User(id: 1, name: "Alice")
+let bytes = try fory.serialize(input)
+let decoded: User = try fory.deserialize(bytes)
+assert(input == decoded)
+```
+
+```bash
+swift run
+```
+
+Swift 使用 xlang 模式。接下来可阅读 [Swift 
对象序列化](../object-serialization/swift/index.md)、[xlang 
类型](../object-serialization/swift/xlang.md)、[配置](../object-serialization/swift/configuration.md)和
 [Schema 演进](../object-serialization/swift/schema-evolution.md)。
+
+## 其他能力
+
+- **Fory IDL 与编译器** 生成 Swift 
模型和注册辅助代码。请参阅[编译器快速入门](../compiler/getting-started.md)和 [Swift 
生成代码指南](../compiler/generated-code/swift.md)。


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to