README: refresh

Author: pawelmhm

README.rst

@@ -21,54 +21,45 @@ Scrapyrt (Scrapy realtime)
 .. image:: https://readthedocs.org/projects/scrapyrt/badge/?version=latest
    :target: https://scrapyrt.readthedocs.io/en/latest/api.html
 
-Introduction
-============
+HTTP API for scheduling `Scrapy <https://scrapy.org/>`_ spiders and receiving their items in response.
 
-HTTP server which provides API for scheduling `Scrapy <https://scrapy.org/>`_ spiders and
-making requests with spiders.
-
-Features
-========
-* Allows you to easily add HTTP API to your existing Scrapy project
-* All Scrapy project components (e.g. middleware, pipelines, extensions) are supported out of the box. 
-* You simply run Scrapyrt in Scrapy project directory and it starts HTTP server allowing you to schedule your spiders and get spider output in JSON format.
-
-Note
-====
-* Project is not a replacement for `Scrapyd <https://scrapyd.readthedocs.io/en/stable/>`_ or `Scrapy Cloud <https://www.zyte.com/scrapy-cloud/>`_ or other infrastructure to run long running crawls
-* Not suitable for long running spiders, good for spiders that will fetch one response from some website and return response
-
-Getting started
+Quickstart
 ===============
 
-To install Scrapyrt::
+**1. install**
 
-    pip install scrapyrt
+    > pip install scrapyrt
 
-Now you can run Scrapyrt from within Scrapy project by just typing::
+**2. switch to Scrapy project (e.g. quotesbot project)**
 
-    scrapyrt
+    > cd ../quotesbot
 
-in Scrapy project directory.
+**3. launch ScrapyRT**
 
-Scrapyrt will look for ``scrapy.cfg`` file to determine your project settings,
-and will raise error if it won't find one.  Note that you need to have all
-your project requirements installed.
+    > scrapyrt
 
-Scrapyrt supports endpoint ``/crawl.json`` that can be requested
-with two methods: GET and POST.
+**4. run your spiders**
 
-To run sample toscrape-css spider from `Quotesbot <https://github.com/scrapy/quotesbot>`_
-parsing page about famous quotes::
+    > curl "localhost:9080/crawl.json?spider_name=toscrape-css&url=http://quotes.toscrape.com/"
 
-    curl "http://localhost:9080/crawl.json?spider_name=toscrape-css&url=http://quotes.toscrape.com/"
+**5. run more complex query, e.g. specify callback**
 
+    >  curl --data '{"request": {"url": "http://quotes.toscrape.com/page/2/"}, "spider_name": "toscrape-css", "crawl_args": {"callback":"other"}}' http://localhost:9080/crawl.json -v
 
-To run same spider only allowing one request and parsing url
-with callback ``parse_foo``::
+Scrapyrt will look for ``scrapy.cfg`` file to determine your project settings,
+and will raise error if it won't find one.  Note that you need to have all
+your project requirements installed.
 
-    curl "http://localhost:9080/crawl.json?spider_name=toscrape-css&url=http://quotes.toscrape.com/&callback=parse_foo&max_requests=1"
+Features
+========
+* Allows you to easily add HTTP API to existing Scrapy project
+* All Scrapy project components (e.g. middleware, pipelines, extensions) are supported out of the box. 
+* You simply run Scrapyrt in Scrapy project directory and it starts HTTP server allowing you to schedule your spiders and get spider output in JSON format.
 
+Note
+====
+* Project is not a replacement for `Scrapyd <https://scrapyd.readthedocs.io/en/stable/>`_ or `Scrapy Cloud <https://www.zyte.com/scrapy-cloud/>`_ or other infrastructure to run long running crawls
+* Not suitable for long running spiders, good for spiders that will fetch one response from some website and return response
 
 
 Documentation