Rebrand the .six by adding a punchline and a faq (#520)

* Add punchline to readme

* Add punchline to docs

* Add frequently asked questions

* Update docs/source/faq.rst

Co-authored-by: Jake Stockwin <jstockwin@gmail.com>

* Update docs/source/faq.rst

Co-authored-by: Jake Stockwin <jstockwin@gmail.com>

* Update docs/source/faq.rst

Co-authored-by: Jake Stockwin <jstockwin@gmail.com>

* Update faq.rst

Co-authored-by: Jake Stockwin <jstockwin@gmail.com>

README.md

@@ -5,6 +5,8 @@ pdfminer.six
 [![PyPI version](https://img.shields.io/pypi/v/pdfminer.six.svg)](https://pypi.python.org/pypi/pdfminer.six/)
 [![gitter](https://badges.gitter.im/pdfminer-six/Lobby.svg)](https://gitter.im/pdfminer-six/Lobby?utm_source=badge&utm_medium)
 
+*We fathom PDF*
+
 Pdfminer.six is a community maintained fork of the original PDFMiner. It is a
 tool for extracting information from PDF documents. It focuses on getting
 and analyzing text data. Pdfminer.six extracts the text from a page directly

docs/source/faq.rst

@@ -0,0 +1,41 @@
+.. _faq:
+
+Frequently asked questions
+**************************
+
+Why is it called pdfminer.six?
+==============================
+
+Pdfminer.six is a fork of the `original pdfminer created by Euske
+<https://github.com/euske>`_. Almost all of the code and architecture is in
+fact created by Euske. But, for a long time this original pdfminer did not
+support Python 3. Until 2020 the original pdfminer only supported Python 2.
+The original goal of pdfminer.six was to add support for Python 3. This was
+done with the six package. The six package helps to write code that is
+compatible with both Python 2 and Python 3. Hence, pdfminer.six.
+
+As of 2020, pdfminer.six dropped the support for Python 2 because it was
+`end-of-life <https://www.python.org/doc/sunset-python-2/>`_. While the .six
+part is no longer applicable, we kept the name to prevent breaking changes for
+existing users.
+
+The current punchline "We fathom PDF" is a `whimsical reference
+<https://github.com/pdfminer/pdfminer.six/issues/197#issuecomment-655091942>`_
+to the six. Fathom means both deeply understanding something, and a fathom is
+also equal to six feet.
+
+How does pdfminer.six compare to other forks of pdfminer?
+==========================================================
+
+Pdfminer.six is now an independent and community maintained package for
+extracting text from PDF's with Python. We actively fix bugs (also for PDF's
+that don't strictly follow the PDF Reference), add new features and improve
+the usability of pdfminer.six. This community separates pdfminer.six from the
+other forks of the original pdfminer. PDF as a format is very diverse and
+there are countless deviations from the official format. The only way to
+support all the PDF's out there is to have a community that actively uses and
+improves pdfminer.
+
+Since 2020, the original pdfminer is `dormant
+<https://github.com/euske/pdfminer#pdfminer>`_, and pdfminer.six is the fork
+which Euske recommends if you need an actively maintained version of pdfminer.

docs/source/index.rst

@@ -13,6 +13,7 @@ Welcome to pdfminer.six's documentation!
     :target: https://gitter.im/pdfminer-six/Lobby?utm_source=badge&utm_medium
     :alt: gitter badge
 
+We fathom PDF.
 
 Pdfminer.six is a python package for extracting information from PDF documents.
 
@@ -38,6 +39,7 @@ pdfminer.six.
     howto/index
     topic/index
     reference/index
+    faq
 
 
 Features

docs/source/reference/highlevel.rst

@@ -26,3 +26,5 @@ extract_pages
 
 .. currentmodule:: pdfminer.high_level
 .. autofunction:: extract_pages
+
+.. _api_extract_pages: