From ba577dfc52c2f69d988ed14c20b47afa17cde49e Mon Sep 17 00:00:00 2001 From: Shanshan Shen <467638484@qq.com> Date: Mon, 30 Jun 2025 17:21:44 +0800 Subject: [PATCH] [Doc] Add Structured Output guide (#1499) ### What this PR does / why we need it? Add Structured Output guide. Signed-off-by: shen-shanshan <467638484@qq.com> --- docs/source/index.md | 1 + .../user_guide/images/structured_output_1.png | Bin 0 -> 58483 bytes docs/source/user_guide/structured_output.md | 163 ++++++++++++++++++ 3 files changed, 164 insertions(+) create mode 100644 docs/source/user_guide/images/structured_output_1.png create mode 100644 docs/source/user_guide/structured_output.md diff --git a/docs/source/index.md b/docs/source/index.md index d9756d7..4030709 100644 --- a/docs/source/index.md +++ b/docs/source/index.md @@ -51,6 +51,7 @@ user_guide/sleep_mode user_guide/graph_mode.md user_guide/quantization.md user_guide/release_notes +user_guide/structured_output ::: % How to contribute to the vLLM Ascend project diff --git a/docs/source/user_guide/images/structured_output_1.png b/docs/source/user_guide/images/structured_output_1.png new file mode 100644 index 0000000000000000000000000000000000000000..4e37502f7376115f0f3da9e7058f4697c394a846 GIT binary patch literal 58483 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