Files
happy-llm/Extra-Chapter/Readme.md
KMnO4-zx 418ac68375 docs(README): 更新README中的Extra Chapter说明和PR规范
更新README.md中的Extra Chapter部分,添加了日期标记并格式化说明文本。同时新增Extra-Chapter/Readme.md文件,详细说明Extra Chapter的目的、内容类型和PR贡献规范。

新增Extra-Chapter/Readme.md文件,包含:
- Extra Chapter的设立目的和内容类型
- PR贡献规范(目录结构、文件命名、内容质量要求)
- PR commit message模板
2025-07-11 22:31:49 +08:00

121 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<div align="center">
<h2>🚀 Happy-LLM 扩展内容</h2>
<p><em>社区驱动的大语言模型学习资源</em></p>
</div>
---
## 📖 为什么会有 Extra Chapter
&emsp;&emsp;在 Happy-LLM 主教程的基础上,我们发现社区中有许多优秀的学习者和实践者,他们在学习和使用大语言模型的过程中积累了宝贵的经验、独到的见解和实用的技巧。这些内容虽然不属于主教程的核心知识体系,但对于深入理解和应用大语言模型具有重要价值。
**Extra Chapter 的设立目的:**
- 🌟 **汇聚智慧**:收集社区成员的优秀学习笔记、实践经验和技术博客
- 🔄 **持续更新**:保持内容的时效性,跟上大语言模型领域的快速发展
- 🤝 **促进交流**:为社区成员提供分享和交流的平台
- 📚 **补充完善**:对主教程内容进行有益的补充和扩展
- 💡 **启发思考**:通过不同视角和实践案例,启发读者的深度思考
**Extra Chapter 包含的内容类型:**
- 📝 **学习笔记**:深度学习心得和知识总结
- 🛠️ **实践案例**:真实项目中的应用经验
- 🔬 **技术探索**:前沿技术的研究和实验
- 💭 **思考感悟**:对大语言模型发展的独特见解
- 🎯 **专题研究**:特定领域或问题的深入分析
---
## 📋 PR 贡献规范
&emsp;&emsp;我们热烈欢迎社区成员为 Extra Chapter 贡献优质内容!为了保证内容质量和项目的整体性,请遵循以下规范:
### 🗂️ 目录结构规范
每个贡献的内容应按照以下目录结构组织:
```
Extra-Chapter/
├── your-topic-name/ # 你的主题文件夹
│ ├── readme.md # 主要内容文件(必需)
│ ├── images/ # 图片资源文件夹(可选)
│ │ ├── figure1.png
│ │ └── figure2.jpg
│ ├── code/ # 代码文件夹(可选)
│ │ ├── example.py
│ │ └── requirements.txt
│ ├── data/ # 数据文件夹(可选)
│ │ └── sample_data.json
│ └── notebook.ipynb # Jupyter Notebook如涉及代码必选
└── Readme.md # 本文件
```
### 📝 文件命名规范
1. **主题文件夹命名**
- 使用小写字母和连字符
- 名称要简洁明了,能够概括主题内容
- 例如:`why-fine-tune-small-large-language-models``rag-optimization-techniques`
2. **主要内容文件**
- 必须命名为 `readme.md`
- 使用 Markdown 格式编写
3. **图片文件**
- 统一放在 `images/` 文件夹下
- 使用描述性的文件名
- 支持格式:`.png``.jpg``.jpeg``.gif``.svg`
4. **代码文件**
- 如涉及代码,请尽量提供可直接运行的 Jupyter Notebook 文件
- 统一放在 `code/` 文件夹下
- 使用标准的文件扩展名
- 如有依赖,请提供 `requirements.txt`
- 如有 Jupyter Notebook 文件,请放在主文件夹下
### ✍️ 内容质量要求
1. **原创性**
- 内容必须是原创或经过授权的
- 如引用他人内容,请注明出处
2. **技术准确性**
- 确保技术内容的准确性
- 代码示例应能正常运行
- 提供必要的环境说明
3. **结构清晰**
- 使用清晰的标题层次
- 合理使用列表、表格等格式
- 重要内容使用适当的强调
4. **语言规范**
- 使用规范的中文表达
- 技术术语使用准确
- 避免错别字和语法错误
### PR commit messgae 内容
请在 PR commit message 中 包含以下内容:
- 新增的主题文件夹名称
- 贡献内容的概述
- 贡献内容的详细描述
- 你的 Github 个人主页链接,及你的个人介绍
- 个人 title 及工作经历 or 学校 or 研究方向
如以下所示:
```
Extra Chapter: 你的主题名称
详细描述你的贡献内容,包括新增的主题文件夹、文件内容和目录结构。
- 新增的主题文件夹名称your-topic-name
- 贡献内容的概述:详细介绍你的贡献内容
- 贡献内容的详细描述:详细描述你的贡献内容,包括新增的主题文件夹、文件内容和目录结构。
- 你的 Github 个人主页链接及个人介绍:[你的个人主页链接](https://example.com),介绍你的研究方向、技术专长等。
- 个人 title 及工作经历 or 学校 or 研究方向:内容贡献者-xxxx学校研究方向为自然语言处理。
```