docs: local development page (#491)

* go

* go

* go

* go

* go

* rename

* Apply suggestions from code review

Co-authored-by: Eden Zimbelman <zim@o526.net>

* slack run callout

* tweak

---------

Co-authored-by: Eden Zimbelman <zim@o526.net>

Author: lukegalbraithrussell

docs/_sidebar.json

@@ -17,6 +17,7 @@
             "tools/slack-cli/guides/using-slack-cli-with-bolt-frameworks",
             "tools/slack-cli/guides/using-slack-cli-on-an-enterprise-grid-organization",
             "tools/slack-cli/guides/running-slack-cli-commands",
+            "tools/slack-cli/guides/developing-locally",
             "tools/slack-cli/guides/using-environment-variables-with-the-slack-cli",
             "tools/slack-cli/guides/troubleshooting-slack-cli-errors",
             "tools/slack-cli/guides/setting-up-ci-cd-with-the-slack-cli",

docs/guides/developing-locally.md

@@ -0,0 +1,45 @@
+---
+sidebar_label: Developing locally
+slug: /tools/slack-cli/guides/developing-locally
+---
+
+# Developing locally using the Slack CLI
+
+The Slack CLI provides some features, and customization of said features, to streamline developing apps locally using `slack run`. This guide details those features.
+
+## Configuring file watching and auto-restart
+
+The Slack CLI automatically watches your app files and restarts the server when they change. It also watches `manifest.json` and reinstalls the app when the manifest changes.
+
+For Bolt for Python projects, the Slack CLI watches all `.py` files from the root directory.
+
+For Bolt for JavaScript projects, the Slack CLI watches all `.js` files from the root directory.
+
+View the [hooks reference](/tools/slack-cli/reference/hooks#watch-configurations) for detailed configuration options.
+
+### Customizing watch paths
+
+You can override the default watch paths in `.slack/hooks.json` if so desired. 
+
+For example, if you want to watch for changes to JavaScript files in an `src` directory but not `scripts` use the following:
+
+```json
+{
+  "config": {
+    "watch": {
+      "manifest": {
+        "paths": ["manifest.json"]
+      },
+      "app": {
+        "paths": ["src/"]
+      }
+    }
+  }
+}
+```
+
+A restart _clears application state_. This is usually desired! Just be aware of this if you're testing workflows that require data to persist across multiple user interactions.
+
+### Using a remote manifest
+
+By default, the Slack CLI uses your local manifest and reinstalls the app if it changes. If you manage your manifest in App Settings, however, you'll have `manifest.source` set to `remote` in `.slack/config.json` and will need to update the manifest in App Settings.