Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/twbs/rorschach.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChris Rebert <github@rebertia.com>2014-06-17 15:59:50 +0400
committerChris Rebert <github@rebertia.com>2014-06-17 15:59:50 +0400
commit38b99be991d06f81f2882df9c05a750b8a722944 (patch)
tree32777430ac4691de2a1148991c93b938e6c550a3
parent78eeec780c71db770c1755506e2ce1e5af69291e (diff)
add Motivation section to README
-rw-r--r--README.md11
1 files changed, 11 insertions, 0 deletions
diff --git a/README.md b/README.md
index 5578a2f..0e0a841 100644
--- a/README.md
+++ b/README.md
@@ -4,3 +4,14 @@ Rorschach
[![Requirements Status](https://requires.io/github/cvrebert/rorschach/requirements.png?branch=master)](https://requires.io/github/cvrebert/rorschach/requirements/?branch=master)
[Bootstrap](https://github.com/twbs/bootstrap/) pull request sanity checker
+
+## Motivation
+
+You're a member of a popular open source project that involves front-end Web technologies. Cool.
+
+But due to the project's popularity, you will get some pull requests proposed by folks who don't read the contributing guidelines, folks who don't understand asset pipelines, or just plain newbies (hey, everybody's gotta start somewhere).
+
+By automating the process of sanity-checking proposed pull requests:
+* Feedback can be given to the pull requester *extremely* quickly, decreasing the turnaround time on fixing the pull request and decreasing friction for the requester.
+* The requester can be refered to canonical write-ups explaining the common mistakes in detail, so that they have full context for understanding the reported mistakes.
+* Issue triagers will have less work to deal with, and human error in failing to zealously check every single pull request for every common mistake is eliminated.