From d08f4a02156bcea308a97ea8ccde919f56340520 Mon Sep 17 00:00:00 2001
From: Akash Santra <santraakash999@gmail.com>
Date: Sat, 11 Apr 2026 11:08:16 +0530
Subject: [PATCH] docs: fix grammar, formatting and clarity issues in docs
 (#28832)

---
 docs/introduction.mdx              | 2 +-
 docs/self-hosting/docker.mdx       | 6 +++---
 docs/self-hosting/installation.mdx | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/introduction.mdx b/docs/introduction.mdx
index d57697becd541f..a905b0de2f296f 100644
--- a/docs/introduction.mdx
+++ b/docs/introduction.mdx
@@ -17,7 +17,7 @@ import config from "@project-config"
   <div>
     ## Quick start
 
-    Feeling like an eager beaver? Jump in to the quick start docs and get making your first request:
+    Feeling like an eager beaver? Jump into the quick start docs and get making your first request:
 
     <div className="flex">
       <Button size="smb" variant="pill" href="/docs/introduction/quick-start">
diff --git a/docs/self-hosting/docker.mdx b/docs/self-hosting/docker.mdx
index bf100b687254ea..558238a05ef8e0 100644
--- a/docs/self-hosting/docker.mdx
+++ b/docs/self-hosting/docker.mdx
@@ -35,7 +35,7 @@ Note: `docker compose` without the hyphen is now the primary method of using doc
     cd cal.com
     ```
 
-3. Prepare your configuration: Rename .env.example to .env and then update .env
+3. Prepare your configuration: Rename `.env.example` to `.env` and then update `.env`
     ```
     cp .env.example .env
     ```
@@ -70,7 +70,7 @@ Note: `docker compose` without the hyphen is now the primary method of using doc
 
 6. Open a browser to [http://localhost:3000](http://localhost:3000), or your defined NEXT_PUBLIC_WEBAPP_URL. The first time you run Cal.com, a setup wizard will initialize. Define your first user, and you're ready to go!
 
-### Update Calcom Instance
+### Update Cal.com Instance
 
 1. Stop the Cal.com stack
 
@@ -118,7 +118,7 @@ For more detailed instructions on how to build and configure your own Docker ima
 
 ### CLIENT_FETCH_ERROR
 
-If you experience this error, it may be the way the default Auth callback in the server is using the WEBAPP_URL as a base url. The container does not necessarily have access to the same DNS as your local machine, and therefor needs to be configured to resolve to itself. You may be able to correct this by configuring `NEXTAUTH_URL=http://localhost:3000/api/auth`, to help the backend loop back to itself.
+If you experience this error, it may be the way the default Auth callback in the server is using the WEBAPP_URL as a base url. The container does not necessarily have access to the same DNS as your local machine, and therefore needs to be configured to resolve to itself. You may be able to correct this by configuring `NEXTAUTH_URL=http://localhost:3000/api/auth`, to help the backend loop back to itself.
 ```
 docker-calcom-1  | @calcom/web:start: [next-auth][error][CLIENT_FETCH_ERROR]
 docker-calcom-1  | @calcom/web:start: https://next-auth.js.org/errors#client_fetch_error request to http://testing.localhost:3000/api/auth/session failed, reason: getaddrinfo ENOTFOUND testing.localhost {
diff --git a/docs/self-hosting/installation.mdx b/docs/self-hosting/installation.mdx
index 7c7bae576b8a57..2622b4baca32f6 100644
--- a/docs/self-hosting/installation.mdx
+++ b/docs/self-hosting/installation.mdx
@@ -54,7 +54,7 @@ For preview deployments on **Vercel**, please leave the following environment va
     ```
     openssl rand -base64 32
     ```
-    (or another secret generator tool if you prefer) to generate a key and add it under `NEXTAUTH_SECRET` in the .env file.
+    (or another secret generator tool if you prefer) to generate a key and add it under `NEXTAUTH_SECRET` in the `.env` file.
 
 5. You'll also want to fill out the `.env.appStore` file similar to the `.env` file as this includes keys to enable apps.