add faq.rst

docs/_isso/layout.html

@@ -86,7 +86,7 @@
             </header>
             <nav>
                 <ul>
-                    <li><a href="{{ pathto('news') }}">News</a></li>
+                    <li><a href="{{ pathto('faq') }}">FAQ</a></li>
                     <li><a href="{{ pathto('contribute') }}">Contribute</a></li>
                     <li><a href="{{ pathto('docs') }}">Documentation</a></li>
                 </ul>

docs/_static/css/site.scss

@@ -298,6 +298,21 @@ main {
       margin-bottom: 0;
     }
 
+    blockquote {
+      margin: 1em;
+      text-align: center;
+      font-size:125%;
+      font-style:italic;
+
+    }
+    blockquote:before {
+      content: "» ";
+    }
+
+    blockquote:after {
+      content: " «";
+    }
+
     ul {
 
       margin: 1em 0;

docs/docs/index.rst

@@ -33,18 +33,18 @@ times).
 
 Isso is not the first open-source commenting server:
 
-  * `talkatv <https://github.com/talkatv/talkatv>`_, written in Python.
-    Unfortunately, talkatv's (read "talkative") development stalled. Neither
-    anonymous nor threaded comments.
+* `talkatv <https://github.com/talkatv/talkatv>`_, written in Python.
+  Unfortunately, talkatv's (read "talkative") development stalled. Neither
+  anonymous nor threaded comments.
 
-  * `Juvia <https://github.com/phusion/juvia>`_, written in Ruby (on Rails).
-    No threaded comments, nice administration webinterface, but... yeah... Ruby.
+* `Juvia <https://github.com/phusion/juvia>`_, written in Ruby (on Rails).
+  No threaded comments, nice administration webinterface, but... yeah... Ruby.
 
-  * `Tildehash.com <http://www.tildehash.com/?article=why-im-reinventing-disqus>`_,
-    written in PHP__ (compare to Python__). Did I forgot something?
+* `Tildehash.com <http://www.tildehash.com/?article=why-im-reinventing-disqus>`_,
+  written in PHP__ (compare to Python__). Did I forgot something?
 
-  * `Unobtrusive, self-hosted comments <http://stackoverflow.com/q/2053217>`_,
-    discussion on StackOverflow.
+* `Unobtrusive, self-hosted comments <http://stackoverflow.com/q/2053217>`_,
+  discussion on StackOverflow.
 
 .. __: http://www.cvedetails.com/vendor/74/PHP.html
 .. __: http://www.cvedetails.com/vendor/10210/Python.html

docs/faq.rst

@@ -0,0 +1,32 @@
+Frequently asked question
+=========================
+
+Why not use Gravatar/Libravatar/... ?
+-------------------------------------
+
+Various people asked or complained about the generated icons next to their
+comments. First, it is not an avatar, it is an identicon used to
+*identify* an author of multiple comments without leaking personal
+informations (unlike Gravatar).
+
+If you are in need of Gravatar_, then use Disqus. If you run your own
+Libravatar_ server, you can work on a patch for Isso which adds *optional*
+support for avatars.
+
+.. _Gravatar: https://secure.gravatar.com/
+.. _Libravatar: http://libravatar.org/
+
+Why SQLite3?
+------------
+
+Although partially answered on the index page, here a more complete answer: If
+you manage massive amounts of comments, Isso is a really bad choice. Isso is
+designed to be simple and easy to setup, not optimizied for high-traffic
+websites (use a `dedicated Disqus`_ instance then).
+
+    comments are not big data
+
+For example, 209 threads and 778 comments in total only need 620K (kilobyte)
+memory. Excellent use case for SQLite.
+
+.. _dedicated Disqus: