贡献指南
感谢你对止危感兴趣!以下是参与项目的方式与规范。
参与方式
- 提交 Issue:反馈 Bug、提出功能建议
- 提交 PR:修复问题、新增功能、完善文档
- 分享案例:将你的监测项目经验写成 实践案例
- 回答问题:在 Issue 与讨论区帮助其他用户
开发流程
- Fork 本仓库
- 创建功能分支:
git checkout -b feat/xxx - 提交代码:
git commit -m "feat: xxx" - 推送分支:
git push origin feat/xxx - 发起 Pull Request
提交规范
提交信息遵循 Conventional Commits:
feat:新功能fix:修复 Bugdocs:文档更新style:代码格式调整refactor:重构test:测试相关chore:构建与工具
代码规范
- 前端:使用项目 ESLint / Prettier 配置
- 后端:遵循项目选定的语言规范
- 类型:优先使用 TypeScript 类型定义
- 测试:新增功能请补充对应测试
文档贡献
文档位于 shm-docs/ 目录,使用 VitePress 编写。修改后请本地运行 pnpm docs:dev 预览。
行为准则
- 尊重他人,保持友善
- 讨论问题时聚焦事实与方案
- 遵守 MIT 协议与开源精神