PR feedback

Author: technically-tracy

docs/content/building-an-app.md

@@ -40,7 +40,7 @@ There are three main token types available to a Slack app: user (`xoxp`), bot (`
 
 We're going to use bot and app-level tokens for this guide.
 
-1. Navigate to the **OAuth & Permissions** on the left sidebar and scroll down to the **Bot Token Scopes** section. Click **Add an OAuth Scope**.
+1. Navigate to **OAuth & Permissions** on the left sidebar and scroll down to the **Bot Token Scopes** section. Click **Add an OAuth Scope**.
 
 2. For now, we'll just add one scope: [`chat:write`](https://docs.slack.dev/reference/scopes/chat.write). This grants your app the permission to post messages in channels it's a member of.
 
@@ -363,7 +363,7 @@ if __name__ == "__main__":
 
 The value inside of `say()` is now an object that contains an array of `blocks`. Blocks are the building components of a Slack message and can range from text to images to datepickers. In this case, your app will respond with a section block that includes a button as an accessory. Since we're using `blocks`, the `text` is a fallback for notifications and accessibility.
 
-You'll notice in the button `accessory` object, there is an `action_id`. This will act as a unique identifier for the button so your app can specify what action it wants to respond to.
+You'll notice in the button `accessory` object, there is an `action_id`. This will act as a unique identifier for the button so your app can specify which action it wants to respond to.
 
 :::tip[Using Block Kit Builder]
 
@@ -373,7 +373,7 @@ The [Block Kit Builder](https://app.slack.com/block-kit-builder) is an simple wa
 
 Now, if you restart your app and say "hello" in a channel your app is in, you'll see a message with a button. But if you click the button, nothing happens (_yet!_).
 
-Let's add a handler to send a followup message when someone clicks the button:
+Let's add a handler to send a follow-up message when someone clicks the button:
 
 <Tabs groupId="socket-or-http">
 <TabItem value="socket-mode" label="Socket Mode">

docs/content/getting-started.md

@@ -10,7 +10,7 @@ This quickstart guide aims to help you get a Slack app using Bolt for Python up
 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/slackapi/bolt-python/tree/main/examples/getting_started) running to modify and make your own.
+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]
 
@@ -20,7 +20,9 @@ In search of the complete guide to building an app from scratch? Check out the [
 
 #### Prerequisites
 
-A few tools are needed for the following steps. We recommend using the [**Slack CLI**](https://tools.slack.dev/slack-cli/) for the smoothest experience, but other options remain available.
+A few tools are needed for the following steps. We recommend using the [**Slack CLI**](https://tools.slack.dev/slack-cli/) for the smoothest experience, but other options remain available. 
+
+You can also begin by installing git and downloading 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:
 
@@ -63,7 +65,7 @@ $ slack create first-bolt-app --template slack-samples/bolt-python-getting-start
 $ cd first-bolt-app
 ```
 
-After a project is created you'll have a `package.json` file for app dependencies and a `.slack` directory for Slack CLI configuration.
+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.
 
@@ -193,9 +195,17 @@ The defaults included leave opportunities abound, so to personalize this app let
 
 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 message listener after the "hello" handler:
+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
 
-// SAMPLE CODE HERE
+@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.