README/FAQ: Split out Troubleshooting README section into FAQ.md.

Also update link at top of README to allow functioning on PyPI, and
adjust the gitlint rule to allow sections to include 'FAQ'.

.gitlint

@@ -29,7 +29,7 @@ line-length=76
 
 [area-formatting]
 # This is a ZT custom rule; these are excluded from the lower-case area rule
-exclusions=WIP, DEBUG, README, CHANGELOG, LICENSE
+exclusions=WIP, DEBUG, README, CHANGELOG, LICENSE, FAQ
 
 [ignore-by-title]
 # Ignore all rules for commits of which the title matches below

README.md

@@ -2,7 +2,7 @@
 
 An interactive terminal interface for [Zulip](https://zulip.com).
 
-[Recent changes](https://github.com/zulip/zulip-terminal/blob/master/CHANGELOG.md) | [Configuration](#Configuration) | [Hot Keys](#hot-keys) | [Troubleshooting](#troubleshooting-common-issues) | [Development](#contributor-guidelines)
+[Recent changes](https://github.com/zulip/zulip-terminal/blob/master/CHANGELOG.md) | [Configuration](#Configuration) | [Hot Keys](#hot-keys) | [FAQs](https://github.com/zulip/zulip-terminal/blob/master/docs/FAQ.md) | [Development](#contributor-guidelines)
 
 [![Zulip chat](https://img.shields.io/badge/zulip-join_chat-brightgreen.svg)](https://chat.zulip.org/#narrow/stream/206-zulip-terminal)
 [![PyPI](https://img.shields.io/pypi/v/zulip-term.svg)](https://pypi.python.org/pypi/zulip-term)
@@ -196,48 +196,6 @@ source ~/.zshenv
 
 **Note:** You can use `arrows`, `home`, `end`, `Page up` and `Page down` keys to move around in Zulip-Terminal.
 
-## Troubleshooting: Common issues
-
-### Unable to render non-ASCII characters
-
-**NOTE** Releases of 0.3.2 onwards should not have this issue, or require this solution.
-
-If you see `?` in place of emojis or Zulip Terminal gives a `UnicodeError` / `CanvasError`, you haven't enabled utf-8
-encoding in your terminal. To enable it by default, add this to the end of you `~/.bashrc`:
-
-```
-export LANG=en_US.utf-8
-```
-
-### Unable to open links
-
-If you are unable to open links in messages, then try double right-click on the link.
-
-Alternatively, you might try different modifier keys (eg. shift, ctrl, alt) with a right-click.
-
-If you are still facing problems, please discuss it at
-[#zulip-terminal](https://chat.zulip.org/#narrow/stream/206-zulip-terminal) or open an issue
-for it mentioning your terminal name, version, and OS.
-
-### Mouse does not support *performing some action/feature*
-
-We think of Zulip Terminal as a keyboard-centric client. Consequently, while functionality via the mouse does work in places, mouse support is not currently a priority for the project (see also [#248](https://www.github.com/zulip/zulip-terminal/issues/248)).
-
-### Above mentioned hotkeys don't work as described
-
-If any of the above mentioned hotkeys don't work for you, feel free to open an issue or discuss it on [#zulip-terminal](https://chat.zulip.org/#narrow/stream/206-zulip-terminal).
-
-### Zulip-term crashed!
-
-We hope this doesn't happen, but would love to hear about this in order to fix it, since the application should be increasingly stable! Please let us know the problem, and if you're able to duplicate the issue, on the github issue-tracker or at [#zulip-terminal](https://chat.zulip.org/#narrow/stream/206-zulip-terminal).
-
-This process would be helped if you could send us the 'traceback' showing the cause of the error, which should be output in such cases:
-* version 0.3.1 and earlier: the error is shown on the terminal;
-* versions 0.3.2+: the error is present/appended to the file `zulip-terminal-tracebacks.log`.
-
-### Something looks wrong! Where's this feature? There's a bug!
-Come meet us on the [#zulip-terminal](https://chat.zulip.org/#narrow/stream/206-zulip-terminal) stream on *chat.zulip.org*.
-
 ## Contributor Guidelines
 
 Zulip Terminal is being built by the awesome [Zulip](https://zulip.com/team) community.

docs/FAQ.md

@@ -0,0 +1,42 @@
+# Frequently Asked Questions (FAQ)
+
+## Unable to render non-ASCII characters
+
+**NOTE** Releases of 0.3.2 onwards should not have this issue, or require this solution.
+
+If you see `?` in place of emojis or Zulip Terminal gives a `UnicodeError` / `CanvasError`, you haven't enabled utf-8
+encoding in your terminal. To enable it by default, add this to the end of you `~/.bashrc`:
+
+```
+export LANG=en_US.utf-8
+```
+
+## Unable to open links
+
+If you are unable to open links in messages, then try double right-click on the link.
+
+Alternatively, you might try different modifier keys (eg. shift, ctrl, alt) with a right-click.
+
+If you are still facing problems, please discuss it at
+[#zulip-terminal](https://chat.zulip.org/#narrow/stream/206-zulip-terminal) or open an issue
+for it mentioning your terminal name, version, and OS.
+
+## Mouse does not support *performing some action/feature*
+
+We think of Zulip Terminal as a keyboard-centric client. Consequently, while functionality via the mouse does work in places, mouse support is not currently a priority for the project (see also [#248](https://www.github.com/zulip/zulip-terminal/issues/248)).
+
+## Above mentioned hotkeys don't work as described
+
+If any of the above mentioned hotkeys don't work for you, feel free to open an issue or discuss it on [#zulip-terminal](https://chat.zulip.org/#narrow/stream/206-zulip-terminal).
+
+## Zulip-term crashed!
+
+We hope this doesn't happen, but would love to hear about this in order to fix it, since the application should be increasingly stable! Please let us know the problem, and if you're able to duplicate the issue, on the github issue-tracker or at [#zulip-terminal](https://chat.zulip.org/#narrow/stream/206-zulip-terminal).
+
+This process would be helped if you could send us the 'traceback' showing the cause of the error, which should be output in such cases:
+* version 0.3.1 and earlier: the error is shown on the terminal;
+* versions 0.3.2+: the error is present/appended to the file `zulip-terminal-tracebacks.log`.
+
+## Something looks wrong! Where's this feature? There's a bug!
+Come meet us on the [#zulip-terminal](https://chat.zulip.org/#narrow/stream/206-zulip-terminal) stream on *chat.zulip.org*.
+