From fd534d391cff7c25e25db5a7a9f81ae3620f5b95 Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Sun, 19 Apr 2026 01:27:08 +0800
Subject: Add documentation for the general_renderer feature

---
 docs/pages/3-features/2-general-renderer.md | 70 +++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)

(limited to 'docs/pages/3-features/2-general-renderer.md')

diff --git a/docs/pages/3-features/2-general-renderer.md b/docs/pages/3-features/2-general-renderer.md
index 230e217..a19fd33 100644
--- a/docs/pages/3-features/2-general-renderer.md
+++ b/docs/pages/3-features/2-general-renderer.md
@@ -4,3 +4,73 @@
 </p>
 
 ---
+
+## Enable Feature
+
+`general_renderer` is a feature provided by **Mingling**. You can enable it in the following way:
+
+```toml
+[dependencies]
+mingling = { 
+    version = "...", 
+    features = ["general_renderer"] 
+}
+```
+
+## Intro
+
+`general_renderer` requires you to implement the `serde::Serialize` trait for **all** structs, so your project needs to include `serde`
+
+```toml
+[dependencies]
+serde = { 
+    version = "1", 
+    features = ["derive"] 
+}
+```
+
+For types wrapped with the `pack!` macro, `serde::Serialize` will be automatically implemented
+
+```rust
+pack!(YourInfo = ()); // Auto derive `serde::Serialize`
+```
+
+For types using the derive macro `Groupped`, you need to manually implement `serde::Serialize`
+
+```rust
+#[derive(Default, Groupped, Serialize)]
+struct YourInfo {
+    name: String,
+    age: i32,
+}
+```
+
+> 💡 Tips
+> 
+> If there are types that do not implement `serde::Serialize`, compilation will fail.
+
+## Import GeneralRendererSetup
+
+`general_renderer` provides a Setup type called `GeneralRendererSetup`. 
+
+After importing it into your program, 
+user inputs like `--json`, `--yaml`, `--toml`, `--ron`, `--json-pretty`, and `--ron-pretty` will be automatically recognized. 
+
+During the **rendering phase**, instead of the **default renderer**, the serialized content will be displayed to the terminal.
+
+```rust
+fn main() {
+    let mut program = ThisProgram::new();
+
+    // Add General Renderer
+    program.with_setup(GeneralRendererSetup);
+
+    // Add Dispatchers
+    program.with_dispatchers((
+        // Your dispatchers
+    ));
+
+    // Execute
+    program.exec();
+}
+```
-- 
cgit