项目的自述文档(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(二)代码讲解与修改
780 0
在线预览项目kkFileView(二)代码讲解与修改
|
5月前
|
域名解析
用vitepress搭建文档网站踩坑记录
之前用 vuepress2 + vite 成功搭建了一个博客网站,这不 vue3 的文档改用 vitepress 搭建的,看着挺好看的,就想着也来折腾折腾搭建一个工作的文档网站
65 0
|
9月前
|
数据库 开发者
软工工程文档
软工工程文档
36 0
|
9月前
|
API
给项目写README文档
给项目写README文档
55 0
|
10月前
|
持续交付
十分钟用vitepress搭建项目文档
十分钟用vitepress搭建项目文档
169 0
|
JSON 数据格式 开发者
用gitbook写一篇开源文档并不难
如何基于 gitbook 搭建文档站点,不涉及开源文档编写规范。
202 0
使用语雀创建文档
使用语雀创建文档
308 0
使用语雀创建文档
|
前端开发 持续交付 开发工具
Hexo 优化配置汇总【GitHub Actions 看板娘 数学公式 标签云 README 转义问题】
Hexo 优化配置汇总【GitHub Actions 看板娘 数学公式 标签云 README 转义问题】
203 0
Hexo 优化配置汇总【GitHub Actions 看板娘 数学公式 标签云 README 转义问题】
|
移动开发 前端开发 JavaScript
使用 VuePress 搭建一个自己的知识文档
最近准备对前端知识做一个梳理,将自己的平时遇到的问题和解决方案形成一个知识文档。 本文记录了搭建 VuePress 的主要过程,同时也提供了部分自定义的配置,示例地址:http://doc.i-fanr.com
412 0