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

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

翻译自@PurpleBoothREADME 模板

项目标题

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

获得开始

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

先决条件

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

给一些例子

安装使用

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

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

给出示例

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

运行测试程序

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

分解为端到端测试

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

给出示例

编码样式测试

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

给出示例

部署

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

内置

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

投稿

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

版本

我们使用 https://semver.org/lang/zh-CN/ 进行版本控制。

作者

致谢

  • 感谢所有使用本项目的人
  • 激励
  • etc
目录
相关文章
|
3月前
|
Rust JavaScript
从零开始写一套广告组件【三】编写README.md
现在项目已经有了,但是我们还没有正式的介绍我们的项目和添加 ` License` 文件,这一章我们就一起来看看如何写一个**README.md**
47 5
从零开始写一套广告组件【三】编写README.md
|
4月前
|
存储
好看又规范的Github Readme 制作指南
本文是关于制作规范且外观吸引人的GitHub README文件的指南,包括了README的基本结构、美化技巧,以及如何使用Markdown格式、徽标和图片来增强文档的可读性和吸引力。
425 0
|
5月前
VuePress 开发技术文档网站,管理.md文件,生成静态网站
VuePress 开发技术文档网站,管理.md文件,生成静态网站
148 0
|
6月前
|
移动开发 JavaScript 前端开发
必知的技术知识:JqueryMedia插件使用,解决在线预览及打开PDF文件
必知的技术知识:JqueryMedia插件使用,解决在线预览及打开PDF文件
给项目写README文档
给项目写README文档
94 0
为你的项目做一份Rmarkdown报告吧
markdown是一种轻量级标记语言,现在许多软件例如Mou、MarkdownEditor、Haroopad、Typora等,通过这些工具可以便捷的完成markdown文字录入,并且支持导出PDF、HTML等格式。对markdown语法还不太了解的人,请自行百度了解,个人认为只要花上几个小时你就能掌握,确实没什么难度,本文主要简单介绍R环境中的markdown,也就是Rmarkdown这个包怎么一步步的制作我们的项目报告。
100 0
|
API
gitHub的readme页的卡片和提交活动图的制作方法
gitHub的readme页的卡片和提交活动图的制作方法
340 0
gitHub的readme页的卡片和提交活动图的制作方法
|
JavaScript API
Docsify使用指南(打造最快捷、最轻量级的个人&团队文档)
Docsify使用指南(打造最快捷、最轻量级的个人&团队文档)
1333 0
Docsify使用指南(打造最快捷、最轻量级的个人&团队文档)
|
前端开发 开发者 微服务
项目第七天内容介绍 | 学习笔记
快速学习 项目第七天内容介绍
|
Ubuntu 安全 数据可视化
干货|教你使用Doxygen制作出漂亮程序文档
不知道大家有没有把自己的代码整理成文档的习惯,有没有给自己的代码一个非常漂亮的注释,就像下图这样。
1972 0
干货|教你使用Doxygen制作出漂亮程序文档