From a44b5084e4940bbfac67f918dc923bec81d7ff0f Mon Sep 17 00:00:00 2001
From: syuilo <syuilotan@yahoo.co.jp>
Date: Wed, 22 Feb 2017 20:19:34 +0900
Subject: [PATCH] Better README

---
 README.md | 65 +++++++++++++++++++++++++++++++------------------------
 1 file changed, 37 insertions(+), 28 deletions(-)

diff --git a/README.md b/README.md
index 32b86f8dc6..41479241ec 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,6 @@
-# Misskey
+Misskey
+================================
+
 [![][travis-badge]][travis-link]
 [![][appveyor-badge]][appveyor-link]
 [![][dependencies-badge]][dependencies-link]
@@ -8,15 +10,15 @@
 [![][himawari-badge]][himasaku]
 [![][sakurako-badge]][himasaku]
 
-[![Sauce Test Status][saucelabs-image]][saucelabs-url]
-
 Welcome!
 
-Misskey is a completely open source, ultimately sophisticated new type of mini-blog based SNS.
+[Misskey](https://misskey.xyz) is a completely open source,
+ultimately sophisticated new type of mini-blog based SNS.
 
 ![ss](./resources/ss.jpg)
 
-## Features
+Key features
+--------------------------------
 * Automatically updated timeline
 * Private chatting (messaging)
 * Free 1GB storage
@@ -26,21 +28,11 @@ Misskey is a completely open source, ultimately sophisticated new type of mini-b
 
 and more! You can touch with your own eyes at https://misskey.xyz/.
 
-## Building
-1. Install *git*, *Node.js* and *npm*
-2. `git clone git://github.com/syuilo/misskey.git`
-3. `cd misskey`
-4. `npm install`
-5. `npm run build`
-
-GLHF!
-
-## Testing
-Run `npm test` after building
-
-## Setup
+Setup
+--------------------------------
 ### Dependencies :package:
 Please install these softwares.
+* *Node.js* and *npm*
 * **[MongoDB](https://www.mongodb.com/)**
 * **[Redis](https://redis.io/)**
 * **[GraphicsMagick](http://www.graphicsmagick.org/)**
@@ -57,7 +49,7 @@ Misskey requires two domains called the primary domain and the secondary domain.
 **Ensure that the secondary domain is not a subdomain of the primary domain.**
 
 #### Subdomains
-Misskey uses following subdomains:
+Note that Misskey uses following subdomains:
 
 * **api**.*{primary domain}*
 * **auth**.*{primary domain}*
@@ -65,10 +57,11 @@ Misskey uses following subdomains:
 * **dev**.*{primary domain}*
 * **file**.*{secondary domain}*
 
-### reCAPTCHA
+### reCAPTCHA tokens
 Please visit https://www.google.com/recaptcha/intro/ and generate keys.
 
-## Setup with Docker :whale:
+Setup with Docker :whale:
+--------------------------------
 Ensure that the working directory is the repository root directory.
 
 To create misskey image:
@@ -90,15 +83,31 @@ If you want to run misskey in production mode, add `--env NODE_ENV=production` l
 
 Note that `$(pwd)` is the working directory.
 
-## Launch
+Building
+--------------------------------
+1. `git clone git://github.com/syuilo/misskey.git`
+2. `cd misskey`
+3. `npm install`
+4. `npm run build`
+
+GLHF!
+
+Launch
+--------------------------------
 (初回起動時はまず `npm run config` してください)
 `sudo npm start`
 
-## Debugging :bug:
+Testing
+--------------------------------
+Run `npm test` after building
+
+Debugging :bug:
+--------------------------------
 ### Show a debug messages
 Misskey uses [debug](https://github.com/visionmedia/debug) and namespace is `misskey:*`.
 
-## Contribute
+Contribute
+--------------------------------
 Do you have feature request or problem with Misskey?
 Please create issue to report it if it is about the Misskey implementation itself.
 
@@ -114,12 +123,14 @@ Pull requests are always welcome.
 * More [docs](./docs)!
 * More cleaning up code!
 
-## Collaborators
+Collaborators
+------------------------------
 | ![syuilo](https://avatars2.githubusercontent.com/u/4439005?v=3&s=70) | ![Morisawa Aya](https://avatars0.githubusercontent.com/u/10798641?v=3&s=70)
 |---|---|
 | [syuilo](https://syuilo.com) | [Aya Morisawa](https://github.com/ayamorisawa)|
 
-## Copyright
+Copyright
+------------------------------
 Misskey is an open-source software licensed under [The MIT License](LICENSE).
 
 🍮
@@ -132,8 +143,6 @@ Misskey is an open-source software licensed under [The MIT License](LICENSE).
 [appveyor-badge]:     https://img.shields.io/appveyor/ci/syuilo/misskey/master.svg?style=flat-square&label=Windows
 [dependencies-link]:  https://gemnasium.com/syuilo/misskey
 [dependencies-badge]: https://img.shields.io/gemnasium/syuilo/misskey.svg?style=flat-square
-[saucelabs-image]:    https://saucelabs.com/browser-matrix/syuilo.svg
-[saucelabs-url]:      https://saucelabs.com/u/syuilo
 [saythanks]:          https://saythanks.io/to/syuilo
 [saythanks-badge]:    https://img.shields.io/badge/SayThanks.io-☼-1EAEDB.svg?style=flat-square
 [himasaku]:           https://himasaku.net