项目的自述文档(README)模板

简介: 翻译自@PurpleBooth 的 README 模板项目标题使用一段话简要描述项目内容。获得开始这些说明将为您提供一个在你的个人本地计算机上启动和运行的项目副本,以便进行开发和测试。有关如何在实时系统上部署项目的细节,请参阅部署。

翻译自@PurpleBoothREADME 模板

项目标题

使用一段话简要描述项目内容。

获得开始

这些说明将为您提供一个在你的个人本地计算机上启动和运行的项目副本,以便进行开发和测试。有关如何在实时系统上部署项目的细节,请参阅部署。

先决条件

需要安装什么软件以及如何安装它们。

给一些例子

安装使用

提供一些例子说明你是如何部署运行的环境的。

表述部署的步骤是什么,并给出示例:

给出示例

最后,以一个小 demo 结束:从外部获取数据,并使用部署好的环境展示项目。

运行测试程序

解释如何提供这个系统的自动化测试。

分解为端到端测试

解释测试的内容以及原因。

给出示例

编码样式测试

解释测试的内容以及原因。

给出示例

部署

添加有关如何在实时系统部署此项的其他说明。

内置

  • 使用的框架,如 Dropwizard
  • 依赖项管理,如 Maven
  • 用于生成 RSS 源,如 ROME

投稿

请阅读 CONTRIBUTING.md,了解我们的行为准则以及如何向我们提交拉取请求的过程。

版本

我们使用 https://semver.org/lang/zh-CN/ 进行版本控制。有关可用的版本,请:book:此存储库中的标记

作者

另请参阅参与此项目的贡献者列表。

许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE.md 文件。

致谢

  • 感谢所有使用本项目的人
  • 激励
  • etc
目录
相关文章
|
Java 数据安全/隐私保护
在线预览项目kkFileView(二)代码讲解与修改
在线预览项目kkFileView(二)代码讲解与修改
897 0
在线预览项目kkFileView(二)代码讲解与修改
|
9天前
|
Rust JavaScript
从零开始写一套广告组件【三】编写README.md
现在项目已经有了,但是我们还没有正式的介绍我们的项目和添加 ` License` 文件,这一章我们就一起来看看如何写一个**README.md**
29 5
从零开始写一套广告组件【三】编写README.md
|
2月前
|
存储
好看又规范的Github Readme 制作指南
本文是关于制作规范且外观吸引人的GitHub README文件的指南,包括了README的基本结构、美化技巧,以及如何使用Markdown格式、徽标和图片来增强文档的可读性和吸引力。
138 0
|
5月前
|
JavaScript Java 测试技术
基于springboot+vue.js的基于保信息学科平台系统附带文章和源代码设计说明文档ppt
基于springboot+vue.js的基于保信息学科平台系统附带文章和源代码设计说明文档ppt
40 10
基于springboot+vue.js的基于保信息学科平台系统附带文章和源代码设计说明文档ppt
|
3月前
VuePress 开发技术文档网站,管理.md文件,生成静态网站
VuePress 开发技术文档网站,管理.md文件,生成静态网站
76 0
|
5月前
|
JavaScript Java 测试技术
基于ssm+vue.js的智慧城市实验室主页系统附带文章和源代码设计说明文档ppt
基于ssm+vue.js的智慧城市实验室主页系统附带文章和源代码设计说明文档ppt
40 5
|
4月前
|
移动开发 JavaScript 前端开发
必知的技术知识:JqueryMedia插件使用,解决在线预览及打开PDF文件
必知的技术知识:JqueryMedia插件使用,解决在线预览及打开PDF文件
|
5月前
|
JavaScript Java 测试技术
Java项目基于ssm+vue.js的实验室管理与排课系统附带文章和源代码设计说明文档ppt
Java项目基于ssm+vue.js的实验室管理与排课系统附带文章和源代码设计说明文档ppt
24 0
|
5月前
|
程序员 vr&ar
【虚幻引擎】DTProjectSettings 蓝图获取基本项目配置插件使用说明 获取项目命名,项目版本,公司名,公司识别名,主页,联系方式
本插件可以使用蓝图获取到项目的一些基本配置,如获取:公司名、公司识别名、版权声明、描述、主页、许可条款、隐私政策、项目ID、项目命名、项目版本、支持联系方式、项目显示标题、项目调试标题信息、应保留窗口宽高比、使用无边框窗口、以VR启动、允许窗口重设大小、允许关闭、允许最大化、允许最小化、虚假立体渲染设备的眼部偏移、视野用于虚假立体渲染设备。
62 0
【虚幻引擎】DTProjectSettings 蓝图获取基本项目配置插件使用说明 获取项目命名,项目版本,公司名,公司识别名,主页,联系方式
|
数据库 开发者
软工工程文档
软工工程文档
70 0