docs: 新增结果位置语义文档和示例代码

[jinzhongjia]

No description provided.

[gemini-code-assist]

Summary of Changes

Hello @jinzhongjia, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

此拉取请求旨在通过新增一个深入的文档章节，详细解释 Zig 语言中的“结果位置语义”和“声明字面量”这两个核心概念。同时，它还引入了一套新的文档编写规范，旨在确保所有代码示例的可测试性、版本兼容性和代码质量，从而提升整个项目文档的维护性和准确性。

Highlights

• 新增核心概念文档: 新增了关于 Zig 语言“结果位置语义”和“声明字面量”的详细文档，深入解释了这些核心类型系统机制。
• 引入文档编写规范: 引入了全面的文档编写规范，包括代码与文档分离原则、代码片段标记（#region/#endregion）和引用语法（<<<@），旨在提升文档质量和可维护性。
• 更新导航与示例代码: 更新了侧边栏导航，将“结果位置语义”章节添加到“进阶学习”部分，并提供了丰富的 Zig 示例代码以支持新文档内容。

Changelog

• AGENTS.md
  • 新增了“文档编写规范”章节，详细说明了代码与文档分离原则、添加新文档章节的完整流程、代码片段标记详解、文档样式规范、中英文排版以及多版本代码维护策略。
• course/.vitepress/sidebar.ts
  • 在“进阶学习”分类下新增了“结果位置语义”的导航链接。
• course/advanced/result-location.md
  • 新增了关于“结果位置语义”的文档，内容涵盖其定义、结果类型（变量声明、函数返回值、函数参数、结构体字段默认值）、结果位置传播、声明字面量（基本用法、字段默认值、调用函数、与错误联合类型配合）、避免错误的字段默认值问题以及在标准库中的应用。
• course/basic/advanced_type/struct.md
  • 更新了对“结果位置语义”的引用，使其链接到新创建的文档页面。
• course/code/15/result-location.zig
  • 新增了与“结果位置语义”文档配套的 Zig 示例代码，通过 #region 标记划分了多个代码片段，用于在文档中引用。

Activity

• 此拉取请求新增了关于 Zig 语言“结果位置语义”的文档和示例代码。

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

本次 PR 新增了关于“结果位置语义”的文档和对应的代码示例，并更新了贡献者指南。整体实现得很好，文档清晰，代码示例也很全面。我发现了一些可以改进的地方：

1. 在 AGENTS.md 中，VitePress 自定义容器的语法有几处拼写错误。
2. 在 result-location.zig 示例代码中，文件末尾的单元测试与各个示例结构体内部的测试存在代码重复，并且部分顶级测试用例并不完整。

我已经针对这些问题提出了具体的修改建议。