Skip to content

docs: fix grammar, formatting and clarity issues in docs#28832

Merged
sahitya-chandra merged 1 commit intocalcom:mainfrom
Akash504-ai:docs/fix-docs-issues
Apr 11, 2026
Merged

docs: fix grammar, formatting and clarity issues in docs#28832
sahitya-chandra merged 1 commit intocalcom:mainfrom
Akash504-ai:docs/fix-docs-issues

Conversation

@Akash504-ai
Copy link
Copy Markdown
Contributor

What does this PR do?

  • Fixes minor grammar issues in documentation
  • Improves formatting for .env references
  • Corrects naming inconsistencies (e.g., Cal.com)
  • Enhances clarity in setup instructions

Visual Demo

N/A (documentation-only changes)

Mandatory Tasks

  • I have self-reviewed the code
  • I have updated the developer docs in /docs if required (N/A)
  • I confirm automated tests are in place or N/A (documentation-only)

How should this be tested?

  • Review the updated documentation files:
    • docs/introduction.mdx
    • docs/self-hosting/docker.mdx
    • docs/self-hosting/installation.mdx
  • Ensure formatting, grammar, and clarity improvements are correct

Checklist

  • My PR is small and focused (docs only)

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 10, 2026

📝 Walkthrough

Walkthrough

The pull request updates documentation files with minor text adjustments and formatting improvements. In the introduction documentation, a quick start call-to-action phrase was rephrased. The Docker self-hosting guide received three updates: filename formatting was corrected with inline code quoting, a section header was modified for proper branding capitalization, and a grammar correction was made. The installation documentation was updated to properly format a filename reference with backticks. All modifications are documentation-only with no changes to exported entities or code logic.

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the PR's main objective of fixing grammar, formatting, and clarity issues across documentation files.
Description check ✅ Passed The description is well-structured and clearly related to the changeset, explaining the specific improvements made to documentation files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
docs/self-hosting/docker.mdx (1)

121-121: Optional polish: capitalize “URL” for consistency.

Line 121 still uses “base url”; consider “base URL” to match technical style in the rest of the docs.

✏️ Suggested wording tweak
-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.
+If you experience this error, it may be due to how the default Auth callback on the server uses `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.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosting/docker.mdx` at line 121, Update the phrasing to use
consistent capitalization of "URL": change "base url" to "base URL" in the
sentence referencing the default Auth callback and WEBAPP_URL so it reads e.g.
"the default Auth callback in the server is using the WEBAPP_URL as a base URL";
ensure any other instances in the same sentence (WEBAPP_URL, NEXTAUTH_URL)
remain uppercase "URL" for consistency.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@docs/self-hosting/docker.mdx`:
- Line 121: Update the phrasing to use consistent capitalization of "URL":
change "base url" to "base URL" in the sentence referencing the default Auth
callback and WEBAPP_URL so it reads e.g. "the default Auth callback in the
server is using the WEBAPP_URL as a base URL"; ensure any other instances in the
same sentence (WEBAPP_URL, NEXTAUTH_URL) remain uppercase "URL" for consistency.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d4940395-7362-4d87-90fd-c88b3a84dfe9

📥 Commits

Reviewing files that changed from the base of the PR and between f3e07c5 and 9a2ab96.

📒 Files selected for processing (3)
  • docs/introduction.mdx
  • docs/self-hosting/docker.mdx
  • docs/self-hosting/installation.mdx

@sahitya-chandra sahitya-chandra added ready-for-e2e run-ci Approve CI to run for external contributors labels Apr 11, 2026
@sahitya-chandra sahitya-chandra enabled auto-merge (squash) April 11, 2026 05:37
@sahitya-chandra sahitya-chandra merged commit d08f4a0 into calcom:main Apr 11, 2026
74 of 78 checks passed
hackice20 added a commit to hackice20/cal.com that referenced this pull request Apr 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-e2e run-ci Approve CI to run for external contributors size/S

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants