Skip to content

docs: redesign landing comparison as side-by-side + table#129

Merged
pratyush618 merged 2 commits intomasterfrom
docs/comparison-redesign
May 3, 2026
Merged

docs: redesign landing comparison as side-by-side + table#129
pratyush618 merged 2 commits intomasterfrom
docs/comparison-redesign

Conversation

@pratyush618
Copy link
Copy Markdown
Collaborator

Reviewer feedback on the "Less to operate" section of the landing page:

currently user cannot comprehend the benefit without comparing and using tabs its not giving a good look for the use case of comparing. Showcase in a table where user can clearly see that its better faster and more convenient.

The reviewer is right — tabs hide one side of a comparison while showing the other, which is the opposite of what a comparison wants. This PR replaces the tab UI with both panels visible at once, plus a small operational matrix below.

What changes

docs/src/app/(home)/comparison.tsx (full rewrite)

Before — tabbed: clicking a tab swaps the visible code block.

After — two <CodePanel> components rendered side by side on md and up, stacked vertically on mobile (taskito on top), followed by a 4-row <table> showing the operational delta:

Property taskito Celery + Redis
Install `pip install taskito` `pip install celery[redis]` + run Redis daemon
Background services 1 (worker) 3 (worker, beat, Redis)
Default storage SQLite file (built-in) Redis (separate daemon)
Retry config in the example above `max_retries=3` decorator arg `try/except` + `self.retry(exc=…)`

Last row points the reader's eye back at the literal difference visible in the code panels above it.

Visual cues

  • taskito panel gets a faint amber `border-t-2 border-fd-primary` accent + amber label text. Celery panel uses neutral `border-fd-border`. No checkmarks, no "✓ winner" iconography — the data speaks.
  • Captions in the panel headers (`Brokerless · single process` vs `Requires Redis · 3 processes`) frame each side without bloating the chrome.

Side wins

  • Component is now stateless — dropped `useState`, dropped `"use client"`. Renders on the server, smaller client bundle.
  • Dropped the previous 3-stat grid (`Install` / `Services to run` / `Background`) — the differentiator table carries the same information more legibly.
  • Dropped the `Stat` helper component and tab-button plumbing.

docs/src/app/(home)/page.tsx

Sub-copy under the Less to operate heading tweaked from "The same task, two stacks. Pick the one with fewer moving parts.""The same task, two stacks. Side by side, with the operational delta." — frames the new layout instead of the old tab framing.

Test plan

  • `pnpm --dir docs types:check` — clean
  • `pnpm --dir docs lint` — clean (2 known pre-existing scaffold-CSS warnings unchanged)
  • `pnpm --dir docs build` — clean static export
  • CI: `Deploy Docs` job on this PR
  • Manual visual check on the deploy preview / locally:
    • Both code blocks visible side by side at desktop width
    • taskito panel on the left has the amber top accent
    • Differentiator table below renders 4 rows with the right column emphasis
    • At 375px viewport: panels stack (taskito first), table stays legible
    • Dark mode: both panels and table respect theme tokens

Non-goals

  • Not adding a checkmark/cross "winner" column to the table — keeps it factual.
  • Not duplicating the README's 13-row comparison matrix here — landing page wants the punch, full matrix lives at `/docs/more/comparison`.
  • Not changing the section headline — "Less to operate" still works.

@github-actions github-actions Bot added the docs label May 3, 2026
@pratyush618 pratyush618 merged commit f0dfd83 into master May 3, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant