init
This commit is contained in:
108
CONTRIBUTING.md
Normal file
108
CONTRIBUTING.md
Normal file
@@ -0,0 +1,108 @@
|
||||
# SkyLink 贡献指南
|
||||
|
||||
感谢您对 SkyLink 项目的关注!我们欢迎各种形式的贡献。
|
||||
|
||||
## 🐛 报告问题
|
||||
|
||||
如果您发现任何 bug,请通过以下方式报告:
|
||||
|
||||
1. **检查现有 Issue** - 确保该问题还没被报告
|
||||
2. **创建新 Issue** - 提供详细的错误描述、复现步骤和环境信息
|
||||
|
||||
### Issue 模板
|
||||
|
||||
```
|
||||
## 问题描述
|
||||
清晰地描述您遇到的问题
|
||||
|
||||
## 复现步骤
|
||||
1. ...
|
||||
2. ...
|
||||
3. ...
|
||||
|
||||
## 预期行为
|
||||
应该发生什么
|
||||
|
||||
## 实际行为
|
||||
实际上发生了什么
|
||||
|
||||
## 环境信息
|
||||
- 系统: Linux / Windows / macOS
|
||||
- 编译器: gcc / clang / MSVC
|
||||
- 其他相关信息
|
||||
```
|
||||
|
||||
## 📝 提交 Pull Request
|
||||
|
||||
1. **Fork** 本仓库
|
||||
2. **创建特性分支** (`git checkout -b feature/amazing-feature`)
|
||||
3. **提交更改** (`git commit -m 'Add amazing feature'`)
|
||||
4. **推送分支** (`git push origin feature/amazing-feature`)
|
||||
5. **创建 Pull Request**
|
||||
|
||||
### PR 检查清单
|
||||
|
||||
- [ ] 代码遵循项目的编码规范
|
||||
- [ ] 添加了必要的注释和文档
|
||||
- [ ] 更新了相关的 README
|
||||
- [ ] 没有引入新的警告或错误
|
||||
- [ ] 所有测试都通过了
|
||||
|
||||
## 📚 开发规范
|
||||
|
||||
### C++ 代码规范
|
||||
|
||||
- 使用 Google C++ Style Guide (改进版)
|
||||
- 变量名: `snake_case`
|
||||
- 类/结构体: `PascalCase`
|
||||
- 常量: `UPPER_SNAKE_CASE`
|
||||
- 成员变量: `snake_case_` (末尾下划线)
|
||||
- 方法: `camelCase` 或 `snake_case`
|
||||
|
||||
### Kotlin 代码规范
|
||||
|
||||
- 遵循 Kotlin 官方编码规范
|
||||
- 使用 Kotlin idioms
|
||||
- 避免 Java 风格的代码
|
||||
|
||||
### 注释规范
|
||||
|
||||
- 使用中英文混用(优先中文)
|
||||
- 关键逻辑必须有说明
|
||||
- 使用 Doxygen 风格的文档注释
|
||||
|
||||
## 🧪 测试
|
||||
|
||||
在提交 PR 之前,请确保:
|
||||
|
||||
1. 编译不出错
|
||||
2. 没有新的警告
|
||||
3. 功能正常工作
|
||||
4. 不会破坏现有功能
|
||||
|
||||
## 📖 改进文档
|
||||
|
||||
文档改进总是受欢迎的!您可以:
|
||||
|
||||
- 修正拼写错误
|
||||
- 改进说明和示例
|
||||
- 添加新的教程
|
||||
- 翻译文档
|
||||
|
||||
## 🎨 改进设计
|
||||
|
||||
如果您有关于 UI/UX 的建议,请:
|
||||
|
||||
1. 创建一个 Issue 讨论
|
||||
2. 提供设计草图或截图
|
||||
3. 解释您的改进理由
|
||||
|
||||
## 💬 联系我们
|
||||
|
||||
- **邮件**: support@skylink.dev
|
||||
- **讨论**: GitHub Discussions
|
||||
- **问题**: GitHub Issues
|
||||
|
||||
---
|
||||
|
||||
**感谢您的贡献!** 🎉
|
||||
Reference in New Issue
Block a user