-Company is an Emacs extension for performing text completion.\r
-Completion candidates are retrieved from a variety of modular\r
-back-ends, such as Semantic.\r
-\r
-Once installed, enable company-mode with <kbd>M-x company-mode</kbd>.\r
-For further information, see the docstring for `company-mode`.\r
+Company Mode
+====
+
+About
+----
+
+Company is an Emacs extension for performing text completion.
+Completion candidates are retrieved from a variety of modular
+back-ends, such as `abbrev`, `Semantic`, `Eclim`, `etags`, etc.
+
+Screenshots
+----
+
+[<img src="screenshots/company-elisp.png" alt="company-elisp" width="256/>](screenshots/company-elisp.png)
+[<img src="screenshots/company-cpp.png" alt="company-cpp" width="256/>](screenshots/company-cpp.png)
+
+Installation
+----
+
+This package is part of [GNU ELPA](http://elpa.gnu.org/) (<kbd>M-x
+list-packages</kbd>).
+
+Usage
+----
+
+Once installed, enable company-mode with <kbd>M-x company-mode</kbd>.
+
+Completion will start automatically after you type a few letters. Use
+<kbd>M-n</kbd>, <kbd>M-p</kbd>, <kbd><tab></kbd> and <kbd><return></kbd> to
+complete. Search through the completions with <kbd>C-s</kbd>, <kbd>C-r</kbd> and
+<kbd>C-o</kbd>.
+
+To use `company-mode` is all buffers, add the following to your init file:
+
+ (global-company-mode)
+
+To set up preferred back-ends, customize `company-backends`.
+
+Also see this variable's docstring for information on writing a back-end.
+
+For more information, see the docstring for `company-mode`.
+
+Feedback
+----
+
+If you experience any problems or have a feature request, use the
+[Issue Tracker](https://github.com/dgutov/company/issues).