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

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

翻译自@PurpleBoothREADME 模板

项目标题

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

获得开始

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

先决条件

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

给一些例子

安装使用

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

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

给出示例

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

运行测试程序

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

分解为端到端测试

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

给出示例

编码样式测试

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

给出示例

部署

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

内置

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

投稿

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

版本

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

作者

致谢

  • 感谢所有使用本项目的人
  • 激励
  • etc
目录
相关文章
给项目写README文档
给项目写README文档
103 0
|
6月前
|
存储
好看又规范的Github Readme 制作指南
本文是关于制作规范且外观吸引人的GitHub README文件的指南,包括了README的基本结构、美化技巧,以及如何使用Markdown格式、徽标和图片来增强文档的可读性和吸引力。
573 0
|
5月前
|
Rust JavaScript
从零开始写一套广告组件【三】编写README.md
现在项目已经有了,但是我们还没有正式的介绍我们的项目和添加 ` License` 文件,这一章我们就一起来看看如何写一个**README.md**
54 5
从零开始写一套广告组件【三】编写README.md
|
Web App开发 索引 Python
文档发布工具mkdocs
mkdocs是Python的一个对 Markdown 友好的文档生成器。,小巧精美。 MkDocs is a fast, simple and downright gorgeous static site generator that’s geared towards building project documentation.
1466 0
|
7月前
VuePress 开发技术文档网站,管理.md文件,生成静态网站
VuePress 开发技术文档网站,管理.md文件,生成静态网站
185 0
|
NoSQL Unix Linux
根目录下README文档翻译
版权声明:您好,转载请留下本人博客的地址,谢谢 https://blog.csdn.net/hongbochen1223/article/details/35859403 文件目录:/README 注:这是一个测试的,想让广大网友朋友们看一下是直白的翻译比较好,还是根据我自己的理解进行翻译,希望大家提出建议。
1032 0
|
Apache PHP
smarty模版目录疑问
2013年4月5日 15:46:25 今天鼓捣yaf和smarty整合,用var_dump();打印出来了smarty对象,看到他其中存放模版目录的变量是用数组保存的,如下: objSmarty 1 object(Smarty)[15] 2 public 'auto_liter...
1051 0

热门文章

最新文章