diff --git a/configure-environment.mdx b/configure-environment.mdx
index 8f963090..f9c3726b 100644
--- a/configure-environment.mdx
+++ b/configure-environment.mdx
@@ -4,8 +4,7 @@ description: "Define environment parameters for your app"
---
On your first deployment, and when you add new connections thereafter, you may
-need to adjust the configuration of your environment for your app to be ready
-for traffic.
+need to configure your environment for your app to be ready for traffic.
## Connection secrets
@@ -18,9 +17,9 @@ values for your defined connection authentication parameters.
## Model hosting
-Where available, Hypermode defaults to shared model instances. If your app
-requires dedicated instances, refer to the [Hosted Models](/hosted-models)
-documentation for instructions on setting up dedicated models.
+Where available, Hypermode defaults to shared model instances. Refer to the
+[Hosted Models](/hosted-models) documentation for instructions on setting up
+hosted models.
## Scaling your runtime resources
diff --git a/create-project.mdx b/create-project.mdx
index c71213ae..5ddff861 100644
--- a/create-project.mdx
+++ b/create-project.mdx
@@ -9,21 +9,21 @@ create a project through the Hypermode Console or Hyp CLI.
## Create with Hypermode Console
- Hypermode relies on git as a source for project deployment. Through the
+ Hypermode relies on Git as a source for project deployment. Through the
project creation flow, you'll connect Hypermode to your GitHub account.
From your organization home, click **New Project**. Set a name for the project
and click **Create**.
-Once you have created a project, Hypermode prompts you to import the repo with
-your Modus app. To create your first Modus app, see the
-[Modus quickstart](modus/quickstart).
+Once you have created a project, Hypermode prompts you to finish setting up your
+project using the CLI.
-## Import with Hyp CLI
+First, install the Modus CLI and initialize your app. For more information on
+creating your first Modus app, visit the [Modus quickstart](modus/quickstart).
-After you have created your Modus app, you can initialize the app with Hypermode
-through the Hyp CLI. To initialize your Hypermode project, run
+Next, initialize the app with Hypermode through the [Hyp CLI](/hyp-cli) and link
+your GitHub repo with your Modus app to Hypermode using:
```bash
hyp link
@@ -32,3 +32,9 @@ hyp link
This command adds a default GitHub Actions workflow to build your Modus app and
a Hypermode GitHub app for auto-deployment. Once initialized, each commit to the
target branch triggers a deployment.
+
+You can also connect to an existing GitHub repository.
+
+The last step is triggering your first deployment. If you linked your project
+through the Hyp CLI, make sure to push your changes first to trigger a
+deployment.
diff --git a/integrate-api.mdx b/integrate-api.mdx
index df9c3e95..52887bcc 100644
--- a/integrate-api.mdx
+++ b/integrate-api.mdx
@@ -7,8 +7,8 @@ Hypermode makes it easy to incrementally add intelligence your app.
## API endpoint
-You can find your project's API endpoint in the Hypermode Console in the format
-of `https://.hypermode.app/`.
+You can find your project's API endpoint in the Hypermode Console, in your
+project's Home tab, in the format `https://.hypermode.app/`.
## API token
diff --git a/introduction.mdx b/introduction.mdx
index 642745a2..db8dd72a 100644
--- a/introduction.mdx
+++ b/introduction.mdx
@@ -12,7 +12,7 @@ Hypermode is a managed service that provides the workbench and infrastructure to
create **powerful, engaging, and secure AI assistants, APIs, and backend
services**.
-With every push to git, Hypermode automatically builds and deploys your
+With every push to Git, Hypermode automatically builds and deploys your
functions. It creates a live, scalable API for you to preview, test, and promote
to production.
diff --git a/modify-project.mdx b/modify-project.mdx
index 7fd46827..dec6a621 100644
--- a/modify-project.mdx
+++ b/modify-project.mdx
@@ -8,9 +8,9 @@ settings.
## Update project name
-Your project name is a display name only and changing it doesn't impact your
-running app. To update your project display name, click **Settings** →
-**General**. Enter a new name and click **Save**.
+Your project name is display-only and changing it doesn't impact your running
+app. To update your project display name, click **Settings** → **General**.
+Enter a new name and click **Save**.
## Update project slug
diff --git a/observe-functions.mdx b/observe-functions.mdx
index 20d80660..2cd8b180 100644
--- a/observe-functions.mdx
+++ b/observe-functions.mdx
@@ -4,7 +4,7 @@ description: "Understand what's happening within your functions"
---
When you invoke a function or model within your app, Modus records the
-execution. The Hypermode Console makes debugging easy with easy to understand
+execution. The Hypermode Console makes debugging simple with easy to understand
logs and metrics.
## Function runs
diff --git a/quickstart.mdx b/quickstart.mdx
index 55bd230d..769cb6d9 100644
--- a/quickstart.mdx
+++ b/quickstart.mdx
@@ -79,7 +79,8 @@ the basic components of a Modus app and how to deploy it to Hypermode.
Let's dig deeper into the behavior of our AI service when we ran the query by looking at the
**Inferences** page. You can see the step-by-step inference process and the inputs and outputs of
- the model at each step of your function. We can see in this case, it took Llama 4.4 seconds to
+ the model at each step of your function.
+ After invoking the Meta Llama model from the function code, we can see the function execution. In this case, it took Llama 4.4 seconds to
reply to the prompt. We can also see the parameters on both the inputs and outputs.
```json
@@ -134,8 +135,8 @@ the basic components of a Modus app and how to deploy it to Hypermode.
}
```
- Save the file and push an update to your git repo. Hypermode automatically redeploys
- whenever you push an update to the target branch in your git repo. Go back to the Hypermode Console
+ Save the file and push an update to your Git repo. Hypermode automatically redeploys
+ whenever you push an update to the target branch in your Git repo. Go back to the Hypermode Console
and run the same query as before. You should see the response now uses surfing analogies!