some minor doc improvements here and there

--HG--
extra : convert_revision : svn%3Ab85faa78-f9eb-468e-a121-7cced6da292c%40699

scrapy/trunk/docs/faq.rst

@@ -32,7 +32,7 @@ Scrapy requires Python 2.5 or 2.6.
 Does Scrapy "stole" X from Django?
 ----------------------------------
 
-Probably, but we don't like that word. We think Django is a great open source
+Probably, but we don't like that word. We think Django_ is a great open source
 project and an example to follow, so we've used it as an inspiration for
 Scrapy. 
 
@@ -46,3 +46,4 @@ focus on the real problems we need to solve.
 We'd be proud if Scrapy serves as an inspiration for other projects. Feel free
 to stole from us!
 
+.. _Django: http://www.djangoproject.com

scrapy/trunk/docs/intro/index.rst

@@ -1,7 +1,11 @@
 .. _intro:
 
-Introduction
-============
+Getting started
+===============
+
+If you're new to Scrapy, web crawling or screen scraping this chapter will get
+you started quickly by giving you an overview of what Scrapy is and how it
+might help you.
 
 .. toctree::
    :maxdepth: 1
@@ -9,3 +13,20 @@ Introduction
    overview
    install
    tutorial/index
+
+.. seealso::
+
+   If you're new to Python_, you might want to start by getting an idea of what
+   the language is like, to get the most out of Scrapy (since Scrapy is 100%
+   Python).
+
+   If you're new to programming and want to start with Python, take a look at
+   `this list of Python resources for non-programmers`_.
+
+   If you're already familiar with other languages, and want to learn Python
+   quickly, we recommend `Dive Into Python`_.
+
+   .. _Python: http://www.python.org
+   .. _this list of Python resources for non-programmers: http://wiki.python.org/moin/BeginnersGuide/NonProgrammers
+   .. _Dive Into Python: http://www.diveintopython.org
+

scrapy/trunk/docs/intro/overview.rst

@@ -194,8 +194,8 @@ scraping easy and efficient, such as:
 
 * Telnet console for low-level access to the Scrapy process
 
-What next?
-==========
+What's next?
+============
 
 The next obvious steps are for you to `download Scrapy`_, read :ref:`the
 tutorial <intro-tutorial1>` and join `the community`_. Thanks for your

scrapy/trunk/docs/ref/index.rst

@@ -1,5 +1,9 @@
-Reference
-=========
+.. _ref-index:
+
+API Reference
+=============
+
+This section documents the API of Scrapy |version|. For more information see :ref:`misc-api-stability`.
 
 .. toctree::
    :maxdepth: 1

scrapy/trunk/docs/topics/index.rst

@@ -1,5 +1,9 @@
-Topics
-======
+.. _topics-index:
+
+Using Scrapy
+============
+
+This section introduces all key concepts of Scrapy.
 
 .. toctree::
    :maxdepth: 1