贡献者
感谢所有为 NestJS 中文文档项目做出贡献的开发者们!你们的努力让更多中文开发者能够更好地学习和使用 NestJS。
如何贡献
我们欢迎各种形式的贡献:
- 📝 翻译改进:修正翻译错误,提升表达质量
- 🐛 错误修复:发现并修复文档中的错误
- ✨ 内容完善:添加示例代码、补充说明等
- 🎨 界面优化:改进文档网站的用户体验
贡献指南
开始之前
在提交贡献之前,请确保:
- 搜索现有问题:查看 GitHub Issues 是否已有相关讨论
- 了解项目结构:熟悉文档的组织方式和文件结构
- 遵循规范:确保你的贡献符合项目的编码和文档规范
提交步骤
-
Fork 本仓库
# 在 GitHub 上点击 Fork 按钮
git clone https://github.com/YOUR_USERNAME/docs.nestjs.cn.git
cd docs.nestjs.cn
-
创建特性分支
git checkout -b feature/amazing-feature
# 或者
git checkout -b fix/some-bug
-
进行你的修改
- 📝 翻译新内容或改进现有翻译
- 🐛 修复文档中的错误
- ✨ 添加示例代码或补充说明
- 🎨 改进文档的格式和样式
-
测试你的修改
在浏览器中查看你的修改效果
-
提交你的修改
git add .
git commit -m "feat: add some amazing feature"
# 或者
git commit -m "fix: correct translation error"
-
推送到你的分支
git push origin feature/amazing-feature
-
创建 Pull Request
- 访问你的 Fork 仓库页面
- 点击 "New Pull Request" 按钮
- 填写详细的 PR 描述
提交消息规范
我们使用 约定式提交 规范:
<类型>[可选的作用域]: <描述>
[可选的正文]
[可选的脚注]
类型包括:
feat
: 新功能
fix
: 修复问题
docs
: 文档修改
style
: 代码格式修改
refactor
: 重构代码
test
: 测试相关
chore
: 构建过程或辅助工具的变动
示例:
feat(awesome): add new learning resources section
fix(contributors): correct community link
docs(readme): update installation instructions
翻译指南
术语一致性
请参考我们的 术语表 确保翻译的一致性:
英文 |
中文 |
说明 |
Controller |
控制器 |
不翻译为"控制器类" |
Provider |
提供者 |
不翻译为"提供商" |
Module |
模块 |
- |
Service |
服务 |
- |
Decorator |
装饰器 |
- |
Middleware |
中间件 |
- |
Guard |
守卫 |
不翻译为"守护" |
Interceptor |
拦截器 |
- |
Pipe |
管道 |
- |
Exception Filter |
异常过滤器 |
- |
翻译原则
- 准确性:确保翻译内容与原文意思一致
- 流畅性:使用自然的中文表达方式
- 专业性:保持技术术语的准确性
- 一致性:在整个项目中使用统一的术语
代码示例
- 保留所有英文代码和注释
- 仅翻译代码注释中的说明文字
- 变量名和函数名保持英文
文档结构
docs/
├── overview/ # 概览
├── fundamentals/ # 基础概念
├── techniques/ # 技术指南
├── security/ # 安全
├── microservices/ # 微服务
├── graphql/ # GraphQL
├── websockets/ # WebSockets
├── cli/ # CLI
├── recipes/ # 使用指南
├── faq/ # 常见问题
└── ...
社区交流
我们建立了多个交流群,欢迎所有对 NestJS 感兴趣的开发者加入:
QQ 群
- 二群:1031015552(禁止广告)
- 三群:321735506(禁止广告)
Telegram 群
点击加入 TG 群
微信群
微信三群:
如果二维码过期,请添加:
微信一二群,目前只接受开源项目作者、NestJS 文档贡献者、捐赠者。
项目贡献者
此列表由 GitHub Actions 自动生成和更新
特别感谢
- zuohuadong - 项目发起人和主要维护者
- 所有贡献者 - 每一个 Pull Request 和 Issue 都让项目变得更好
- NestJS 官方团队 - 创造了这个优秀的框架
- 中文开发者社区 - 提供了宝贵的反馈和建议
赞助商
感谢以下企业对本项目的支持:
主要赞助商
支持我们
NestJS 是一个基于 MIT 许可证的开源项目,它的持续发展离不开社区的支持。如果你喜欢这个框架,或者你的企业在使用 NestJS,请考虑赞助我们的开发工作,以确保你依赖的项目能够得到积极的维护和改进。
如何支持我们
为什么支持我们很重要
NestJS 没有大公司的持续资金支持,完全依靠社区的善意 ❤️。你的支持将帮助我们:
- 💻 持续开发新功能:让框架变得更加强大和完善
- 📚 创建更多内容:编写教程、博客文章和录制视频
- 🛠️ 及时修复问题:快速响应社区反馈和问题
- 🌱 支持生态发展:维护相关工具和库
企业支持
如果你的企业正在使用 NestJS,可以考虑:
- 📈 企业赞助:通过 企业支持计划 获得专业服务
- 🎓 团队培训:安排 NestJS 官方培训和工作坊
- 💼 技术咨询:获得 NestJS 核心团队的直接技术指导
想要加入我们吗?查看 GitHub 仓库 开始贡献!
许可证
本项目基于 Apache License 2.0 许可证开源。