Skip to content

项目介绍

文件名常见用途
README.md项目入口说明:项目是什么、如何安装、如何使用
OVERVIEW.md项目整体概览、模块划分、核心能力
GETTING_STARTED.md新手快速开始教程
INSTALL.md / INSTALLATION.md安装步骤、环境要求、依赖配置
USAGE.md详细使用方法和示例
QUICKSTART.md最短路径运行项目
TUTORIAL.md系统化教程
FAQ.md常见问题与回答
TROUBLESHOOTING.md故障排查方法
CONFIGURATION.md / CONFIG.md配置项、环境变量、配置文件说明
ARCHITECTURE.md系统架构、模块关系、技术设计
DESIGN.md设计方案、关键决策、实现思路
SPEC.md / SPECIFICATION.md功能规范、协议或接口定义
API.md / API_REFERENCE.mdAPI 接口文档
DATABASE.md数据库结构、表关系、迁移方式
SECURITY.md安全策略、漏洞报告方式
PERFORMANCE.md性能指标、优化方案、压测结果
DEPLOYMENT.md部署流程、服务器或云平台配置
OPERATIONS.md / RUNBOOK.md日常运维、监控、故障恢复步骤
DEVELOPMENT.md本地开发环境、调试方式、开发流程
CONTRIBUTING.md如何参与贡献、提交代码和 PR
CODE_OF_CONDUCT.md社区行为准则
STYLE_GUIDE.md编码、文档或 UI 风格规范
TESTING.md测试策略、运行测试的方法
CHANGELOG.md每个版本的变更记录
RELEASES.md / RELEASE.md版本发布流程或发布说明
ROADMAP.md未来规划和功能路线图
TODO.md待完成事项
MIGRATION.md / UPGRADING.md升级或版本迁移指南
COMPATIBILITY.md兼容的平台、版本、浏览器等
LICENSE.md / LICENSE软件许可证
AUTHORS.md / CONTRIBUTORS.md作者和贡献者名单
ACKNOWLEDGEMENTS.md致谢、第三方项目声明
GOVERNANCE.md项目治理和决策机制
SUPPORT.md获取帮助、联系维护者的方式
MAINTAINERS.md维护者和职责范围
DECISIONS.md重要技术决策记录
ADR/*.mdArchitecture Decision Records,逐条记录架构决策

基于 MIT 许可发布