--- /dev/null
+((nil . ((indent-tabs-mode . nil)
+ (fill-column . 80)
+ (sentence-end-double-space . t)
+ (emacs-lisp-docstring-fill-column . 75))))
--- /dev/null
+* company-statistics
+** About
+Company-statistics is a global minor mode built on top of the in-buffer
+completion system [[http://company-mode.github.io/][company-mode]]. The idea is to keep a log of a certain number
+of completions you choose, along with some context information, and use that to
+rank candidates the next time you have to choose --- hopefully showing you
+likelier candidates at the top of the list.
+** Use It
+Using the package is simple. With the files in your =load=path=, add to your
+=init.el= file
+#+begin_src emacs-lisp
+(require 'company-statistics)
+(company-statistics-mode)
+#+end_src
+to load the package and turn on the mode. See the (few but powerful)
+customizable options for details =M-x customize-group company-statistics=.
+** Design
+Company-statistics relies on company-mode (it works by adding a function to
+company-transformers), but is only loosely coupled to it. It is designed with
+some flexibility in mind as for the recorded context information and the way
+candidates are scored: the default pair of functions are only examples! The
+stats are automatically persistent between sessions.
+** Have Fun!