feat(toggle): Updating toggle docs (#13607)

## DESCRIBE YOUR PR
* This PR updates the toggle documentation for devservices to give a
more detailed view of what it does and how and when it should be used.

## IS YOUR CHANGE URGENT?  

Help us prioritize incoming PRs by letting us know when the change needs
to go live.
- [ ] Urgent deadline (GA date, etc.): <!-- ENTER DATE HERE -->
- [ ] Other deadline: <!-- ENTER DATE HERE -->
- [ ] None: Not urgent, can wait up to 1 week+

## SLA

- Teamwork makes the dream work, so please add a reviewer to your PRs.
- Please give the docs team up to 1 week to review your PR unless you've
added an urgent due date to it.
Thanks in advance for your help!

## PRE-MERGE CHECKLIST

*Make sure you've checked the following before merging your changes:*

- [ ] Checked Vercel preview for correctness, including links
- [ ] PR was reviewed and approved by any necessary SMEs (subject matter
experts)
- [ ] PR was reviewed and approved by a member of the [Sentry docs
team](https://github.com/orgs/getsentry/teams/docs)

Author: IanWoodard

develop-docs/development-infrastructure/devservices.mdx

@@ -84,23 +84,62 @@ devservices up --mode symbolicator
 
 ## Running a dependency locally
 
-If you want to run a dependency locally rather than as a container, you can do so by toggling the runtime to LOCAL.
+You can run a dependency locally instead of as a container by toggling its runtime via the `devservices toggle` command.
 
-For example, if you are running Sentry and want to use your local Snuba, you can do the following:
+### Toggle to local runtime
+
+For example, if you're running Sentry and want to run Snuba **locally** from source, you can toggle Snuba to the local runtime like this:
+
+```shell
+devservices toggle snuba
+```
+
+or you can specify the runtime explicitly:
 
 ```shell
 devservices toggle snuba LOCAL
 ```
 
-This will tell devservices to not bring up snuba and its dependencies, allowing you to run snuba locally instead.
+This tells devservices to treat Snuba as a service that should be started alongside dependent services like Sentry. Dependencies of Snuba, such as Redis, Kafka, and Clickhouse, will still run as containers.
+
+<Alert title="Note">
+  Toggling to LOCAL does not start the dev server for that service. You'll need to start that manually.
+</Alert>
+
+### What happens when you toggle
+
+If Sentry is already running, toggling Snuba to LOCAL will:
+1. Stop Snuba's containers (unless shared by another service)
+2. Start Snuba's non-local dependencies (Redis, Kafka, Clickhouse) as containers
+
+If Sentry is not yet running, the next time `devservices up` is run, Snuba (and any other services you toggle to LOCAL) will be automatically started as local services alongside Sentry.
+
+If you want to bring up Snuba, or other local runtime dependencies in a non-default mode, you can:
+1. Tell devservices to not bring them up automatically by passing the `--exclude-local` flag to `devservices up`.
+2. Bring that mode up manually via `devservices up --mode <mode>` since modes are additive.
+3. Bring that service down and back up again with the new mode.
+
+### Bringing down services with local runtimes
+
+When stopping services with `devservices down`, the default behavior is to stop all services and their dependencies, including dependencies with local runtimes.
+
+If you don't want dependencies with local runtimes to be brought down when bringing down a dependent service, you can pass the `--exclude-local` flag to `devservices down`. This tells devservices to only stop dependencies that are not running with local runtimes.
+
+### Toggle back to containerized runtime
+
+To switch a service back to running in a container, you can do the following:
+
+```shell
+devservices toggle snuba
+```
 
-To toggle the runtime back to using the container, you can do the following:
+Or explicitly specify the runtime:
 
 ```shell
 devservices toggle snuba CONTAINERIZED
 ```
 
-If you don't provide a runtime when toggling, it will toggle to the opposite of the current runtime.
+Replace `snuba` with the name of the service you want to toggle.
 
 ## Migrating data from the deprecated `sentry devservices`