Added a FAQ document.

README.md

@@ -46,8 +46,12 @@ Download
 Release downloads can be found on the [Releases Page](https://github.com/sedwards2009/extraterm/releases). Installation and instructions are in the [guide is here](docs/guide.md).
 
 
+FAQ
+---
+The [FAQ is here](docs/faq.md).
+
+
 Development & Contributing
 --------------------------
-
 Extraterm is an open source project and welcomes contributors. More information about [development is here](docs/development.md).
 

docs/faq.md

@@ -0,0 +1,26 @@
+FAQ
+===
+
+How can I use Extraterm's shell integration over ssh?
+-----------------------------------------------------
+
+To use Extraterm's shell integration across `ssh` two things have to be set up:
+
+* Just like on your local machine the script from the extraterm-commands zip needs to be read in on the remote machine.
+* The `EXTRATERM_COOKIE` environment variable needs to be set on the remote end.
+
+First, before you run `ssh`, print the value of the `EXTRATERM_COOKIE` environment variable.
+```
+echo $EXTRATERM_COOKIE
+```
+Now, run `ssh` to go to your remote machine. Set the `EXTRATERM_COOKIE` environment variable to the value which was just displayed before.
+
+For bash and zshell that is:
+```
+EXTRATERM_COOKIE=<value goes here>
+```
+Fish uses:
+```
+set -x EXTRATERM_COOKIE <value goes here>
+```
+Hopefully this will be made easier in the future.