Skip to content

docs: polish the docs site and hide pricing and managed hosting - #149

Merged
chamals3n4 merged 4 commits into
mainfrom
v1/ui-tweaks
Oct 31, 2026
Merged

chamals3n4 merged 4 commits into
mainfrom
v1/ui-tweaks

Conversation

@chamals3n4

@chamals3n4 chamals3n4 commented Oct 27, 2026 •

Copy link
Copy Markdown
Owner

Purpose

UI fixes for the docs site, and hiding the Pricing and Managed Hosting pages until the hosted service is ready.

Approach

  • Hidden pages: pricing.tsx and managed-hosting.tsx are renamed to _pricing.tsx and _managed-hosting.tsx, which Docusaurus does not build, so /pricing and /managed-hosting are 404s and left out of the sitemap. Their navbar and footer links are commented out. To bring them back, remove the underscore and uncomment the links.
  • Contact page: removed the topic picker and the Cloud/pricing wording. The contact email is now chamals004@gmail.com (CONTACT_EMAIL in offer.ts, also shown in the footer). The footer blurb no longer mentions OpenATS Cloud.
  • Dark mode: docs pages now use the same #0a0a0a background and #1f1f1f borders as the navbar and marketing pages.
  • Code blocks: added Prism grammars for bash/sh, ini, http, sql and nginx (most code blocks had no highlighting), and changed the dotenv blocks to ini (Prism has no dotenv grammar). Dark mode keeps Dracula's token colours on a neutral #171717 background. Light mode keeps GitHub's theme with its cyan and pink replaced by the site's teal and a muted amber.
  • Navbar and footer: bigger "OpenATS" title to match the logo, and no rotate animation on the GitHub star.
  • Tech stack: Nodemailer replaced with TanStack Query, and the Next.js and Docker descriptions reworded.
  • Also on this branch: a small login page change (remove sign in three dot, frontend/app/(auth)/login/page.tsx).

Related issues

  • N/A

Checklist

  • pnpm test passes locally.
  • Schema changes include the generated migration files. (none)
  • Documentation is updated if behaviour changed.
  • No keys, passwords or tokens are committed.

pnpm build in docs/ passes with no broken links.

Summary by CodeRabbit

  • Documentation
    • Updated configuration examples to use INI syntax highlighting.
    • Revised the homepage and contact page descriptions, including updated technology-stack details.
  • New Features
    • Updated the contact form’s email subject format and contact address.
  • Changes
    • Removed topic selection from the contact form and removed Managed Hosting and Pricing links.
    • Updated documentation-site colors and navigation styling, and refined the GitHub icon’s hover behavior.
    • Changed the login button’s loading label to “Signing in.”

- Hide the Pricing and Managed Hosting pages (renamed with a _ prefix so
  Docusaurus skips them) and their navbar and footer links
- Contact page: drop the topic picker and Cloud/pricing wording, and use
  chamals004@gmail.com as the contact email
- Match the dark mode background to the navbar and marketing pages
- Syntax highlighting for bash, ini, http, sql and nginx code blocks, a
  neutral dark code background, and calmer light mode code colours
- Tech stack: replace Nodemailer with TanStack Query and reword the
  Next.js and Docker entries
@vercel

vercel Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
open-ats Ready Ready Preview Oct 27, 2026 1:53pm UTC
openats-docs Ready Ready Preview Oct 27, 2026 1:53pm UTC

@chamals3n4 chamals3n4 added Type/Improvement An improvement to an existing feature Area/Docs README, contributing guide and docs site documentation Docs site, README and guides labels Oct 27, 2026
@coderabbitai

coderabbitai Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review.

Recent review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: dbcd704d-5e59-4d1f-a13b-2767494d4386
Commits

Reviewing files that changed from the base of the PR and between ebc7b91 and 37fdb48.

Files ignored due to path filters: 1
  • docs/static/img/stack/tanstackquery.svg is excluded by !**/*.svg
Files selected for processing: 15
  • docs/docs/administration/authentication.md
  • docs/docs/getting-started/quick-start.md
  • docs/docs/operations/upgrading-to-built-in-auth.md
  • docs/docusaurus.config.ts
  • docs/src/components/GithubStar/styles.module.css
  • docs/src/components/Marketing/ContactForm.tsx
  • docs/src/components/Marketing/marketing.module.css
  • docs/src/components/Marketing/offer.ts
  • docs/src/css/custom.css
  • docs/src/pages/_managed-hosting.tsx
  • docs/src/pages/_pricing.tsx
  • docs/src/pages/contact.tsx
  • docs/src/pages/index.tsx
  • docs/src/theme/Footer/index.tsx
  • frontend/app/(auth)/login/page.tsx
Files with no reviewable changes: 1
  • docs/src/components/Marketing/marketing.module.css

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

Walkthrough

Documentation examples now use INI syntax highlighting. The public site’s navigation, theme, marketing content, and contact form changed. The homepage stack descriptions and login button’s submitting label also changed.

Changes: Documentation and site updates

Layer / File(s) Summary
Configuration example highlighting
docs/docs/administration/authentication.md, docs/docs/getting-started/quick-start.md, docs/docs/operations/upgrading-to-built-in-auth.md
Environment-variable examples use ini code fences instead of dotenv; their displayed values remain unchanged.
Site navigation and theme
docs/docusaurus.config.ts, docs/theme/Footer/index.tsx, docs/src/css/custom.css, docs/src/components/GithubStar/styles.module.css
Managed Hosting and Pricing links are hidden. Prism language and color settings, navbar typography, dark-theme colors, and GitHub star icon styling changed.
Marketing contact content and form
docs/src/components/Marketing/ContactForm.tsx, docs/src/components/Marketing/marketing.module.css, docs/src/components/Marketing/offer.ts, docs/src/pages/contact.tsx, docs/src/theme/Footer/index.tsx
Topic selection was removed from the contact form, which now uses a fixed subject prefix. Contact and footer copy changed, and the contact email address was updated.
Homepage and sign-in text
docs/src/pages/index.tsx, frontend/app/(auth)/login/page.tsx
The homepage stack descriptions changed. The login button’s submitting label changed from “Signing in…” to “Signing in”.

Priority: Low

Estimated code review effort: 2 (Simple) | ~12 minutes

Change: Other

Possibly related PRs

Merge Risk: Minimal · up to 37fdb

No merge-blocking risk was identified in the documentation and site updates.

Pre-merge checks: Passed 4 · Failed 1

Failed Failed checks: 1 warning

Check name Status Explanation Resolution
Docstring Coverage Warning Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Documentation-only edits and deletions within surv… Write docstrings for the functions missing them to satisfy the coverage threshold.
Passed Passed checks: 4 passed
Check name Status Explanation
Title check Passed The title clearly summarizes the primary changes: documentation polish and hiding Pricing and Managed Hosting.
Description check Passed The description covers the purpose, implementation approach, affected pages, related issues, and checklist. It also reports the docs build result and identifies that pnpm test has not been confirmed…
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Full details: Description check

Explanation

The description covers the purpose, implementation approach, affected pages, related issues, and checklist. It also reports the docs build result and identifies that pnpm test has not been confirmed. The breaking impact is described under Approach, although a separate Breaking changes heading is absent.

Full details: Docstring Coverage

Explanation

Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 4 functions across 7 files. (5 skipped: 5 unsupported.)

Resolution

Write docstrings for the functions missing them to satisfy the coverage threshold.

Finishing Touches: 💡 1
📝 Generate docstrings: 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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.

@chamals3n4
chamals3n4 merged commit d55d571 into main Oct 31, 2026
5 checks passed

This branch was successfully deployed

2 active deployments
Preview – openats-docs — 37fdb48f Deployed Oct 27, 2026 by vercel[bot]
Preview – open-ats — 37fdb48f Deployed Oct 27, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Area/Docs README, contributing guide and docs site documentation Docs site, README and guides Type/Improvement An improvement to an existing feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant