如何写一个优秀的GitHub项目README文档？

今天给大家介绍一个Github上的README文档写作教程模版，该模版目前获得6634颗星星，2296Fork，相对而言，还是比较得到大家认可的。不花哨，不别出心裁，一个比较实用的，普适性的架子；所谓教科书式，不外如此。原文是英语，大神可直接看戳我查看。下面是我翻译的中文版（未完全按照原文翻译），献丑了。

项目名称

这里再写一句骚气又精准的话描述你的项目吧。

上手指南

写几句这样的话概括接下来的内容：以下指南将帮助你在本地机器上安装和运行该项目，进行开发和测试。关于如何将该项目部署到在线环境，请参考部署小节。

安装要求

列出运行该项目必须要具备的条件以及必须要安装的软件，最好给出具体的安装步骤。

1. 必须安装我
2. 我也必须安装
3. 安装我也是必须的

安装步骤

一步一步地说明怎么去搭建环境，怎么让项目跑起来。

首先你需要

1. 干这件事
2. 干那件事
3. 继续干这件事
   …一直到完成。

最后阐述安装完成后的情况，展示下Demo

测试

解释说明一下如何运行该系统的自动测试部分。

分解