diff --git a/docs/english/_sidebar.json b/docs/english/_sidebar.json
index aa75b0c15..a525510f0 100644
--- a/docs/english/_sidebar.json
+++ b/docs/english/_sidebar.json
@@ -5,8 +5,6 @@
"label": "Bolt for Python",
"className": "sidebar-title"
},
- "tools/bolt-python/getting-started",
- { "type": "html", "value": "
" },
"tools/bolt-python/creating-an-app",
{
"type": "category",
diff --git a/docs/english/creating-an-app.md b/docs/english/creating-an-app.md
index 66e1febee..a7df2c034 100644
--- a/docs/english/creating-an-app.md
+++ b/docs/english/creating-an-app.md
@@ -4,10 +4,14 @@ sidebar_label: Creating an app
# Creating an app with Bolt for Python
-This guide is meant to walk you through getting up and running with a Slack app using Bolt for Python. Along the way, we’ll create a new Slack app, set up your local environment, and develop an app that listens and responds to messages from a Slack workspace.
+:::tip[More doing, less reading]
+This guide is a more thorough explanation on creating a Slack app. If you want a running app as fast as possible, follow our [Quickstart](/quickstart) that harnesses the power of the [Slack CLI](/tools/slack-cli).
+:::
+
+Follow along to get up and running with a Slack app using Bolt for Python. Along the way, we’ll create a new Slack app, set up your local environment, and develop an app that listens and responds to messages from a Slack workspace.
When you're finished, you'll have created the [Getting Started app](https://github.com/slackapi/bolt-python/tree/main/examples/getting_started) to run, modify, and make your own. ⚡️
-
+
---
### Create a new app {#create-an-app}
@@ -15,7 +19,7 @@ First thing's first: before you start developing with Bolt, you'll want to [crea
:::tip[A place to test and learn]
-We recommend using a workspace where you won't disrupt real work getting done — [you can create a new one for free](https://slack.com/get-started#create).
+We recommend using a workspace where you won't disrupt real work getting done, like a [developer sandbox](/tools/developer-sandboxes).
:::
diff --git a/docs/english/getting-started.md b/docs/english/getting-started.md
deleted file mode 100644
index 8cfd7faf8..000000000
--- a/docs/english/getting-started.md
+++ /dev/null
@@ -1,288 +0,0 @@
----
-sidebar_label: Quickstart
-title: Quickstart guide with Bolt for Python
----
-
-This quickstart guide aims to help you get a Slack app using Bolt for Python up and running as soon as possible!
-
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-
-When complete, you'll have a local environment configured with a customized [app](https://github.com/slack-samples/bolt-python-getting-started-app) running to modify and make your own.
-
-:::tip[Reference for readers]
-
-In search of the complete guide to building an app from scratch? Check out the [building an app](/tools/bolt-python/creating-an-app) guide.
-
-:::
-
-#### Prerequisites
-
-A few tools are needed for the following steps. We recommend using the [**Slack CLI**](/tools/slack-cli/) for the smoothest experience, but other options remain available.
-
-You can also begin by installing git and downloading [Python 3.7 or later](https://www.python.org/downloads/), or the latest stable version of Python. Refer to [Python's setup and building guide](https://devguide.python.org/getting-started/setup-building/) for more details.
-
-Install the latest version of the Slack CLI to get started:
-
-- [Slack CLI for macOS & Linux](/tools/slack-cli/guides/installing-the-slack-cli-for-mac-and-linux)
-- [Slack CLI for Windows](/tools/slack-cli/guides/installing-the-slack-cli-for-windows)
-
-Then confirm a successful installation with the following command:
-
-```sh
-$ slack version
-```
-
-An authenticated login is also required if this hasn't been done before:
-
-```sh
-$ slack login
-```
-
-:::info[A place to belong]
-
-A workspace where development can happen is also needed.
-
-We recommend using [developer sandboxes](/tools/developer-sandboxes) to avoid disruptions where real work gets done.
-
-:::
-
-## Creating a project {#creating-a-project}
-
-With the toolchain configured, it's time to set up a new Bolt project. This contains the code that handles logic for your app.
-
-If you don’t already have a project, let’s create a new one!
-
-
-
-
-A starter template can be used to start with project scaffolding:
-
-```sh
-$ slack create first-bolt-app --template slack-samples/bolt-python-getting-started-app
-$ cd first-bolt-app
-```
-
-After a project is created you'll have a `requirements.txt` file for app dependencies and a `.slack` directory for Slack CLI configuration.
-
-A few other files exist too, but we'll visit these later.
-
-
-
-
-A starter template can be cloned to start with project scaffolding:
-
-```sh
-$ git clone https://github.com/slack-samples/bolt-python-getting-started-app first-bolt-app
-$ cd first-bolt-app
-```
-
-Outlines of a project are taking shape, so we can move on to running the app!
-
-
-
-
-We recommend using a [Python virtual environment](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/#creating-a-virtual-environment) to manage your project's dependencies. This is a great way to prevent conflicts with your system's Python packages. Let's create and activate a new virtual environment with [Python 3.7 or later](https://www.python.org/downloads/):
-
-```sh
-$ python3 -m venv .venv
-$ source .venv/bin/activate
-$ pip install -r requirements.txt
-```
-
-Confirm the virtual environment is active by checking that the path to `python3` is _inside_ your project ([a similar command is available on Windows](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/#activating-a-virtual-environment)):
-
-```sh
-$ which python3
-# Output: /path/to/first-bolt-app/.venv/bin/python3
-```
-
-## Running the app {#running-the-app}
-
-Before you can start developing with Bolt, you will want a running Slack app.
-
-
-
-
-The getting started app template contains a `manifest.json` file with details about an app that we will use to get started. Use the following command and select "Create a new app" to install the app to the team of choice:
-
-```sh
-$ slack run
-...
-⚡️ Bolt app is running!
-```
-
-With the app running, you can test it out with the following steps in Slack:
-
-1. Open a direct message with your app or invite the bot `@first-bolt-app (local)` to a public channel.
-2. Send "hello" to the current conversation and wait for a response.
-3. Click the attached button labelled "Click Me" to post another reply.
-
-After confirming the app responds, celebrate, then interrupt the process by pressing `CTRL+C` in the terminal to stop your app from running.
-
-
-
-
-Navigate to your list of apps and [create a new Slack app](https://api.slack.com/apps/new) using the "from a manifest" option:
-
-1. Select the workspace to develop your app in.
-2. Copy and paste the `manifest.json` file contents to create your app.
-3. Confirm the app features and click "Create".
-
-You'll then land on your app's **Basic Information** page, which is an overview of your app and which contains important credentials:
-
-
-
-To listen for events happening in Slack (such as a new posted message) without opening a port or exposing an endpoint, we will use [Socket Mode](/tools/bolt-python/concepts/socket-mode). This connection requires a specific app token:
-
-1. On the **Basic Information** page, scroll to the **App-Level Tokens** section and click **Generate Token and Scopes**.
-2. Name the token "Development" or something similar and add the `connections:write` scope, then click **Generate**.
-3. Save the generated `xapp` token as an environment variable within your project:
-
-```sh
-$ export SLACK_APP_TOKEN=
-```
-
-The above command works on Linux and macOS but [similar commands are available on Windows](https://superuser.com/questions/212150/how-to-set-env-variable-in-windows-cmd-line/212153#212153).
-
-:::warning[Keep it secret. Keep it safe.]
-
-Treat your tokens like a password and [keep it safe](/concepts/security). Your app uses these to retrieve and send information to Slack.
-
-:::
-
-A bot token is also needed to interact with the Web API methods as your app's bot user. We can gather this as follows:
-
-1. Navigate to the **OAuth & Permissions** on the left sidebar and install your app to your workspace to generate a token.
-2. After authorizing the installation, you'll return to the **OAuth & Permissions** page and find a **Bot User OAuth Token**:
-
-
-
-3. Copy the bot token beginning with `xoxb` from the **OAuth & Permissions page** and then store it in a new environment variable:
-
-```sh
-$ export SLACK_BOT_TOKEN=xoxb-
-```
-
-After saving tokens for the app you created, it is time to run it:
-
-```sh
-$ python3 app.py
-...
-⚡️ Bolt app is running!
-```
-
-With the app running, you can test it out with the following steps in Slack:
-
-1. Open a direct message with your app or invite the bot `@BoltApp` to a public channel.
-2. Send "hello" to the current conversation and wait for a response.
-3. Click the attached button labelled "Click Me" to post another reply.
-
-After confirming the app responds, celebrate, then interrupt the process by pressing `CTRL+C` in the terminal to stop your app from running.
-
-
-
-
-## Updating the app
-
-At this point, you've successfully run the getting started Bolt for Python [app](https://github.com/slack-samples/bolt-python-getting-started-app)!
-
-The defaults included leave opportunities abound, so to personalize this app let's now edit the code to respond with a kind farewell.
-
-#### Responding to a farewell
-
-Chat is a common thing apps do and responding to various types of messages can make conversations more interesting.
-
-Using an editor of choice, open the `app.py` file and add the following import to the top of the file, and message listener after the "hello" handler:
-
-```python
-import random
-
-@app.message("goodbye")
-def message_goodbye(say):
- responses = ["Adios", "Au revoir", "Farewell"]
- parting = random.choice(responses)
- say(f"{parting}!")
-```
-
-Once the file is updated, save the changes and then we'll make sure those changes are being used.
-
-
-
-
-Run the following command and select the app created earlier to start, or restart, your app with the latest changes:
-
-```sh
-$ slack run
-...
-⚡️ Bolt app is running!
-```
-
-After finding the above output appears, open Slack to perform these steps:
-
-1. Return to the direct message or public channel with your bot.
-2. Send "goodbye" to the conversation.
-3. Receive a parting response from before and repeat "goodbye" to find another one.
-
-Your app can be stopped again by pressing `CTRL+C` in the terminal to end these chats.
-
-
-
-
-Run the following command to start, or restart, your app with the latest changes:
-
-```sh
-$ python3 app.py
-...
-⚡️ Bolt app is running!
-```
-
-After finding the above output appears, open Slack to perform these steps:
-
-1. Return to the direct message or public channel with your bot.
-2. Send "goodbye" to the conversation.
-3. Receive a parting response from before and repeat "goodbye" to find another one.
-
-Your app can be stopped again by pressing `CTRL+C` in the terminal to end these chats.
-
-
-
-
-#### Customizing app settings
-
-The created app will have some placeholder values and a small set of [scopes](/reference/scopes) to start, but we recommend exploring the customizations possible on app settings.
-
-
-
-
-Open app settings for your app with the following command:
-
-```sh
-$ slack app settings
-```
-
-This will open the following page in a web browser:
-
-
-
-
-
-
-Browse to https://api.slack.com/apps and select your app "Getting Started Bolt App" from the list.
-
-This will open the following page:
-
-
-
-
-
-
-On these pages you're free to make changes such as updating your app icon, configuring app features, and perhaps even distributing your app!
-
-## Next steps {#next-steps}
-
-You can now continue customizing your app with various features to make it right for whatever job's at hand. Here are some ideas about what to explore next:
-
-- Follow along with the steps that went into making this app on the [creating an app](/tools/bolt-python/creating-an-app) guide for an educational overview.
-- Check out the [Agent quickstart](/ai/agent-quickstart) to get up and running with an agent.
-- Browse our [curated catalog of samples](/samples) for more apps to use as a starting point for development.
\ No newline at end of file