From ecfaf9828e9f26f15b593db140bd7c8ef8c4a664 Mon Sep 17 00:00:00 2001
From: Martin Zimmermann <info@posativ.org>
Date: Wed, 18 Dec 2013 16:20:52 +0100
Subject: [PATCH] add faq.rst

---
 docs/_isso/layout.html     |  2 +-
 docs/_static/css/site.scss | 15 +++++++++++++++
 docs/docs/index.rst        | 18 +++++++++---------
 docs/faq.rst               | 32 ++++++++++++++++++++++++++++++++
 4 files changed, 57 insertions(+), 10 deletions(-)
 create mode 100644 docs/faq.rst

diff --git a/docs/_isso/layout.html b/docs/_isso/layout.html
index bf6c8ea..2462c30 100644
--- a/docs/_isso/layout.html
+++ b/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>
diff --git a/docs/_static/css/site.scss b/docs/_static/css/site.scss
index 669c4f9..9511860 100644
--- a/docs/_static/css/site.scss
+++ b/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;
diff --git a/docs/docs/index.rst b/docs/docs/index.rst
index ebe86ab..6fb5692 100644
--- a/docs/docs/index.rst
+++ b/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
diff --git a/docs/faq.rst b/docs/faq.rst
new file mode 100644
index 0000000..e96d73e
--- /dev/null
+++ b/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: