Update docs to reflect changes for Sentry 8.4
diff --git a/docs/cli/init/index.rst b/docs/cli/init/index.rst
index ac54108f01087..ac0a0852d3a28 100644
--- a/docs/cli/init/index.rst
+++ b/docs/cli/init/index.rst
@@ -6,4 +6,5 @@ Initialize new configuration directory.
 Options
 ```````
 
+- ``--dev``: Use settings more conducive to local development.
 - ``--help``: print this help page.
diff --git a/docs/inbound-mail.rst b/docs/inbound-mail.rst
index f441f012b83c1..4d8627fbfa696 100644
--- a/docs/inbound-mail.rst
+++ b/docs/inbound-mail.rst
@@ -63,7 +63,7 @@ Add another supervisor config to run the Sentry ``smtp`` service::
 
     [program:sentry-inbound-mail]
     directory=/www/sentry/
-    command=/www/sentry/bin/sentry start smtp
+    command=/www/sentry/bin/sentry run smtp
     autostart=true
     autorestart=true
     stdout_logfile syslog
diff --git a/docs/installation.rst b/docs/installation.rst
index a7f35ffd7688b..b85090b197b94 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -300,11 +300,11 @@ get you off the ground quickly, also you can setup Sentry as WSGI
 application, in that case skip to section `Running Sentry as WSGI
 application`.
 
-To start the built-in webserver run ``sentry start``:
+To start the built-in webserver run ``sentry run web``:
 
 ::
 
-  SENTRY_CONF=/etc/sentry sentry start
+  SENTRY_CONF=/etc/sentry sentry run web
 
 You should now be able to test the web service by visiting `http://localhost:9000/`.
 
diff --git a/docs/performance.rst b/docs/performance.rst
index e505c3fd692c3..0c53ca8d56851 100644
--- a/docs/performance.rst
+++ b/docs/performance.rst
@@ -64,7 +64,7 @@ many cores you have on the machine. You can do this either by editing
 
 or can be passed through the command line as::
 
-	$ sentry start -w 16
+	$ sentry run web -w 16
 
 See `uWSGI's official documentation <https://uwsgi-docs.readthedocs.org/en/latest/Options.html>`_
 for more options that can be configured in ``SENTRY_WEB_OPTIONS``.
@@ -103,14 +103,14 @@ e.g. if you had something like:
 
 ```
 numprocs=1
-command=celery worker -c 64
+command=sentry celery worker -c 64
 ```
 
 change it to:
 
 ```
 numprocs=16
-command=celery worker -c 4
+command=sentry celery worker -c 4
 ```
 
 
diff --git a/docs/upgrading.rst b/docs/upgrading.rst
index 7f81f30585529..1f115bebd0434 100644
--- a/docs/upgrading.rst
+++ b/docs/upgrading.rst
@@ -60,7 +60,7 @@ code changes will not be reflected until a restart.
 
 These services include:
 
-- webserver -- ``sentry start``
+- webserver -- ``sentry run web``
 - celery workers -- ``sentry celery worker``
 - celery beat (cron) -- ``sentry celery beat``
 
diff --git a/docs/warnings.rst b/docs/warnings.rst
index 512e5c15f878c..a7d6bace851b5 100644
--- a/docs/warnings.rst
+++ b/docs/warnings.rst
@@ -23,7 +23,7 @@ Now, ``SENTRY_CONF`` should be pointed to the parent directory that contains bot
 the python file and the yaml file. ``sentry init`` will generate the right
 structure needed for the future.::
 
-    $ SENTRY_CONF=/etc/sentry sentry start
+    $ SENTRY_CONF=/etc/sentry sentry run web
 
 The following will be a simple mapping of old (``sentry.conf.py``) keys to new
 (``config.yml``). Old settings should be completely removed.

@getsentry/infrastructure
