docs: rebuild Debug API content

docs/api/XCEngine/Debug/Logger/Warning.md

@@ -1,32 +1,45 @@
 # Logger::Warning
 
-公开方法，详见头文件声明。
+以 `Warning` 级别记录一条日志。
 
 ```cpp
 void Warning(LogCategory category, const Containers::String& message);
 ```
 
-该方法声明于 `XCEngine/Debug/Logger.h`，当前页面用于固定 `Logger` 类目录下的方法级 canonical 路径。
+## 行为说明
 
-**参数：**
-- `category` - 参数语义详见头文件声明。
-- `message` - 参数语义详见头文件声明。
-
-**返回：** `void` - 无返回值。
-
-**示例：**
+这是 `Logger::Log` 的便捷封装，等价于：
 
 ```cpp
-#include <XCEngine/Debug/Logger.h>
+Log(LogLevel::Warning, category, message);
+```
 
-void Example() {
-    XCEngine::Debug::Logger object;
-    // 根据上下文补齐参数后调用 Logger::Warning(...)。
-    (void)object;
-}
+它适合记录“当前还能继续运行，但状态值得关注”的情况。
+
+## 参数
+
+- `category` - 日志分类。
+- `message` - 警告文本。
+
+## 返回值
+
+- 无。
+
+## 线程语义
+
+- 与 [Log](Log.md) 相同。
+
+## 示例
+
+```cpp
+XCEngine::Debug::Logger::Get().Warning(
+    XCEngine::Debug::LogCategory::General,
+    "Created OpenGL context without debug bit"
+);
 ```
 
 ## 相关文档
 
-- [返回类总览](Logger.md)
-- [返回模块目录](../Debug.md)
+- [返回类型总览](Logger.md)
+- [Log](Log.md)
+- [Error](Error.md)