diff --git a/docs/experimental/crawlspider-v2.rst b/docs/experimental/crawlspider-v2.rst
new file mode 100644
index 000000000..a1ea09c48
--- /dev/null
+++ b/docs/experimental/crawlspider-v2.rst
@@ -0,0 +1,128 @@
+.. _topics-crawlspider-v2:
+
+==============
+CrawlSpider v2
+==============
+
+Introduction
+============
+
+TODO: introduction
+
+Rules Matching
+==============
+
+TODO: describe purpose of rules
+
+Request Extractors & Processors
+===============================
+
+TODO: describe purpose of extractors & processors
+
+Examples
+========
+
+TODO: plenty of examples
+
+
+.. module:: scrapy.contrib_exp.crawlspider.spider
+    :synopsis: CrawlSpider
+
+
+Reference
+=========
+
+CrawlSpider
+-----------
+
+TODO: describe crawlspider
+
+.. class:: CrawlSpider
+
+    TODO: describe class
+
+
+.. module:: scrapy.contrib_exp.crawlspider.rules
+    :synopsis: Rules
+
+Rules
+-----
+
+TODO: describe spider rules
+
+.. class:: Rule
+
+    TODO: describe Rules class
+
+
+.. module:: scrapy.contrib_exp.crawlspider.reqext
+    :synopsis: Request Extractors
+
+Request Extractors
+------------------
+
+TODO: describe extractors purpose
+
+.. class:: BaseSgmlRequestExtractor
+
+    TODO: describe base extractor
+
+.. class:: SgmlRequestExtractor
+
+    TODO: describe sgml extractor
+
+.. class:: XPathRequestExtractor
+
+    TODO: describe xpath request extractor
+
+
+.. module:: scrapy.contrib_exp.crawlspider.reqproc
+    :synopsis: Request Processors
+
+Request Processors
+------------------
+
+TODO: describe request processors
+
+.. class:: Canonicalize
+
+    TODO: describe proc
+
+.. class::  Unique
+
+    TODO: describe unique
+
+.. class:: FilterDomain
+
+    TODO: describe filter domain
+
+.. class:: FilterUrl
+
+    TODO: describe filter url
+
+
+.. module:: scrapy.contrib_exp.crawlspider.matchers
+    :synopsis: Matchers
+
+Request/Response Matchers
+-------------------------
+
+TODO: describe matchers
+
+.. class:: BaseMatcher
+
+    TODO: describe base matcher
+
+.. class:: UrlMatcher
+    
+    TODO: describe url matcher
+
+.. class:: UrlRegexMatcher
+    
+    TODO: describe UrlListMatcher
+
+.. class:: UrlListMatcher
+
+    TODO: describe url list matcher
+
+
diff --git a/docs/experimental/index.rst b/docs/experimental/index.rst
index 47f4ee4ac..f63ceddd9 100644
--- a/docs/experimental/index.rst
+++ b/docs/experimental/index.rst
@@ -21,3 +21,4 @@ it's properly merged) . Use at your own risk.
 
    djangoitems
    scheduler-middleware
+   crawlspider-v2