Rework the project's documentation

This migrates all the documentation into Sphinx, and uses automation
to document various pieces of functionality.

Author: pradyunsg

.prettierrc.toml

@@ -0,0 +1 @@
+proseWrap = "always"

.readthedocs.yaml

@@ -0,0 +1,15 @@
+version: 2
+
+build:
+  os: "ubuntu-20.04"
+  tools:
+    python: "3.10"
+
+sphinx:
+  configuration: docs/conf.py
+
+python:
+  install:
+    - requirements: docs/requirements.txt
+    - method: pip
+      path: .

README.md

@@ -0,0 +1,30 @@
+# LiveReload
+
+Reload webpages on changes, without hitting refresh in your browser.
+
+## Installation
+
+<!-- start install -->
+
+LiveReload is for web developers who know Python. It is available on [PyPI].
+
+```
+$ pip install livereload
+```
+
+[pypi]: https://pypi.python.org/pypi/livereload
+
+<!-- end install -->
+
+## Documentation
+
+[LiveReload's documentation is hosted on ReadTheDocs][docs].
+
+[docs]: https://livereload.readthedocs.io/en/latest/
+
+## Security Report
+
+To report a security vulnerability, please use the [Tidelift security contact].
+Tidelift will coordinate the fix and disclosure.
+
+[tidelift security contact]: https://tidelift.com/security

README.rst

@@ -0,0 +1,15 @@
+=============
+API Reference
+=============
+
+Helper Functions
+================
+
+.. autoclass:: livereload.shell
+    :members:
+
+Server
+======
+
+.. autoclass:: livereload.Server
+    :members:

docs/_templates/sidebarintro.html

@@ -0,0 +1,17 @@
+# Command Line Interface
+
+The `livereload` command can be used for starting a live-reloading server, that
+serves a directory.
+
+```{command-output} livereload --help
+
+```
+
+It will listen to port 35729 by default, since that's the usual port for
+[LiveReload browser extensions].
+
+[livereload browser extensions]: https://livereload.com/extensions/
+
+```{versionchanged} 2.0.0
+`Guardfile` is no longer supported. Write a Python script using the API instead.
+```