diff --git a/doc/_templates/index.html b/doc/_templates/index.html
index 0739191e5..e6ef91784 100644
--- a/doc/_templates/index.html
+++ b/doc/_templates/index.html
@@ -21,7 +21,7 @@
- {%trans%}Output formats: HTML (including Windows HTML Help), LaTeX (for
- printable PDF versions), Texinfo, manual pages, plain text{%endtrans%}
+ printable PDF versions), ePub, Texinfo, manual pages, plain text{%endtrans%}
- {%trans%}Extensive cross-references: semantic markup and automatic links
for functions, classes, citations, glossary terms and similar pieces of
information{%endtrans%}
@@ -85,7 +85,16 @@
of this documentation, thanks to the Japanese Sphinx user group.{%endtrans%}
{%trans%}A Japanese book about Sphinx has been published by O'Reilly:
Sphinxをはじめよう /
- Learning Sphinx:{%endtrans%}
- 
+ Learning Sphinx.{%endtrans%}
+
+
+
+ {%trans%}Hosting{%endtrans%}
+
+ {%trans%}Need a place to host your Sphinx docs?
+ readthedocs.org hosts a lot of Sphinx docs
+ already, and integrates well with projects' source control. It also features a
+ powerful built-in search that exceeds the possibilities of Sphinx' JavaScript-based
+ offline search.{%endtrans%}
{% endblock %}
diff --git a/doc/intro.rst b/doc/intro.rst
index 24760aa9e..d1cab1c84 100644
--- a/doc/intro.rst
+++ b/doc/intro.rst
@@ -16,6 +16,10 @@ Though there is support for that kind of docs as well (which is intended to be
freely mixed with hand-written content), if you need pure API docs have a look
at `Epydoc `_, which also understands reST.
+For a great "introduction" to writing docs in general -- the whys and hows, see
+also `Write the docs `_, written by Eric
+Holscher.
+
Conversion from other systems
-----------------------------
@@ -66,12 +70,3 @@ Usage
See :doc:`tutorial` for an introduction. It also contains links to more
advanced sections in this manual for the topics it discusses.
-
-
-Hosting
--------
-
-Need a place to host your Sphinx docs? `readthedocs.org
-`_ hosts a lot of Sphinx docs already, and integrates
-well with projects' source control. It also features a powerful built-in search
-that exceeds the possibilities of Sphinx' JavaScript-based offline search.