As unfortunate as the one-letter name is we agreed to just call it h and
not the service, and this is how it's used elsewhere in the docs.

This generates warnings if cross-references (for example to environment
variables) are broken.

When mentioning an environment variable in Sphinx docs do this:

```
:envvar:`FOO`
```

This will:

1. Render the envvar mention as a `<code class="std-envvar">`
   (among other CSS classes), this is then styled specially by the
   Sphinx theme

2. Automatically hyperlink it to the env var's definition on the
   env vars page

3. Generate a warning if an envvar with that name isn't defined
   (if the -n arg tp sphinx-build is used)

This is for consistency with our variable names and, for example,
environment variable names which use `HOSTNAME` rather than `HOST_NAME`.

I want this file to be in rst so that I can use some rst features in it
in future commits. The main changes in order to translate from markdown
to rst are:

* Inline `<code>` requires double-backticks not single

* These titles don't work:

  ```
  # Heading

  ## Subheading
  ```

  They should be:

  ```
  Heading
  =======

  Subheading
  ----------
  ```

* To get an auto-numbered list, repeatedly using 1 doesn't work:

  ```
  1. First item
  1. Second item
  1. Third item
  ```

  Instead use `#`:

  ```
  #. First item
  #. Second item
  #. Third item
  ```

* Paragraphs starting with `**Tip**:` (and with the contents in italics)
  now become proper tip blocks:

  ```
  .. tip::

     If the output of ``hostname`` does not include a ``.home`` or ``.local``
     suffix, you may need to append ``.local`` to get a host name that is accessible from
     other devices on the network. If you have problems using the host name, try
     using the IP address instead.
  ```

  Sphinx renders these boxes as `<div class="admonition tip">` and
  they're styled by your Sphinx theme (as opposed to hardcoding the tip
  is in bold and the body is italics but otherwise it's just a `<p>`).

* Code blocks are like this:

  ```
  .. code-block:: sh

     First line of code
     Second line of code
  ```

Remove unused controller properties

Remove obsolete `ng-cloak` directives

Add Slack link to README

Invite users and potential contributors to join us on Slack as well as
IRC.

Add docs explaining how to test the client on a real mobile device

Use angle brackets to indicate that HOSTNAME is a placeholder rather
than a dollar-sign to avoid confusion with the `$HOSTNAME` env var.

 * Add note about possible need to add `.local` or `.home` suffix or use
   IP address instead of hostname.
 * Use title case for heading.

Merge pull request #333 from hypothesis/fix-annotating-sites-with-broken-Function.bind-polyfills-take-3

Fix annotating sites with broken function.bind polyfills take 3

Add a lint rule to ensure that new developers do not use `bind` in
annotator/ code. This only applies to first-party code. Third-party code
used in the annotation layer is still at-risk of being broken by old
`bind` polyfills.

Don't call the parent browsing environment's Function.bind() function
from the src/annotator code.

Some parent pages modify Function.protoype.bind(), for example replacing
it with their own broken bind() polyfill, and this causes our code to
crash.

Work around this by just not using bind().

Fixes #245

Translate annotation-sync.coffee to JavaScript

Use new endpoint for creating an annotation flag

This function has no tests and I don't know what it does but sometimes
`undefined` is passed to it as the `annotations` arg and it crashes, so
fix that.

This was a CoffeeScript-generated variable.

This was a CoffeeScript-generated variable.

These were generated by CoffeeScript (due to its implicit returns) but
don't actually appear to be necessary.

Minimal changes to the CoffeeScript-generated annotation-sync.js to
stop `make lint` complaining about it, while still having `make test`
pass.

annotation-sync.js is the unmodified output of
`coffee -bc src/annotator/annotation-sync.coffee`.

Fix Mobile Safari Scrolling

* master:
  Add tests for sidebar closing when user clicks or taps in document
  Fixing tapping anchored annotations not opening sidebar
  Fixing sidebar not closing on outside content click issue
  eslint: Ignore docs/_build
  Update ESLint to v3.18.0