Skip to content

Fix landing page table and roadmap tags, lead Get involved with contribution - #289

Merged
Akshat0694 merged 4 commits into
docs/promote-landing-pagesfrom
fix/landing-table-and-roadmap-badge
Sep 2, 2026
Merged

Fix landing page table and roadmap tags, lead Get involved with contribution#289
Akshat0694 merged 4 commits into
docs/promote-landing-pagesfrom
fix/landing-table-and-roadmap-badge

Conversation

@larisoncarvalho

Copy link
Copy Markdown
Contributor

Pull Request Template

Description

  • What changes are being made?

    • At-scale comparison table. Cleared Infima's default table styling, which was supplying a 1px border on all four sides of every cell plus zebra striping that the design never asked for. Switched the table to table-layout: fixed and sized the middle column to its content, so the three columns are separated by even gutters (58–62px / 60px, previously 61px / 179px).
    • Roadmap status tags. Gave the tag its own grid column so the four line up down the strip instead of landing wherever each title happened to stop. The column has a floor rather than a fixed width, so a status longer than today's two pushes it open instead of spilling a nowrap tag into the body text.
    • Get involved block. Kept the contributor data and copy from 6c6c811 and restyled it: one button instead of four, promoted the label to a heading, and captioned the contributor row. The button is now the good-first-issue list rather than the star.
    • tirith ui banner. Cut from 44 words to 17 so it stops wrapping onto two lines.
  • Why are these changes necessary?

    • The table and tag issues were visible misalignment on a page we are promoting. In both cases the root cause was not the obvious one: the table's cramped gutter was leaked third-party CSS rather than padding, and the tag raggedness was inline layout rather than spacing.
    • In the Get involved block the layout contradicted its own copy. The paragraph says a bug report is "far more valuable than a star", while the loudest element on the block was the star. Starring is not contributing, so the button now points at the good-first-issue list and the star drops to a text link. This also restores the intent recorded in that block's original comment: "the star is the cheap version of it rather than the point."
    • The banner carried four clauses, which is more than a strip read at a glance gets. It now keeps the two things the tool is for; the rest is on the page it links to.
  • Which issues or tickets does this PR close or relate to?

    • Related issue: #

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update
  • Other (please specify): landing page layout and copy. No runtime or CLI code is touched — the diff is two CSS modules and one page component.

Checklist

  • Code has been linted. npm run build passes clean: no broken links, both bundles compile.
  • Documentation has been updated (if needed). Not needed; no documented behaviour changes.
  • Tests have been added or updated (if needed). Not applicable — presentational CSS and copy, with no test surface in this project.
  • Any breaking changes have been communicated to the team. None.

Screenshots or Recordings (if applicable)

Verified in the browser rather than by eye alone; measurements at a 1280px viewport.

Before After
Table gutter, col 1 → 2 61px 62px
Table gutter, col 2 → 3 179px 60px
Roadmap tag left edges 4 different offsets, ~140px spread all aligned
Banner height 68px (two lines) 49px (one line)

Table gutters hold across the desktop range: 58/60 at 880px (just above the 860px stacking breakpoint), 62/60 at 1280, 74/60 at 1500. No cell overflow and no horizontal scroll at the narrowest desktop width. Mobile stacking is unchanged.

Additional Information

  • Based on docs/promote-landing-pages, not main. Targeting that branch keeps this diff to the three files it actually touches. Against main it would drag in the whole promote-landing-pages changeset.
  • This branch was rebased onto 6c6c811 to pick up the contributor script, and force-pushed. The only commits replaced were earlier versions of the two commits in this PR; no one else's work was on the branch, and no PR was open at the time.
  • Two decisions worth a reviewer's attention, both reversible:
    • Watch for releases was briefly dropped as duplicating the star, then kept. As a text link it no longer competes, and the note copy references it by name.
    • Making the good-first-issue list the primary action reverses the order the links previously appeared in. If the goal for this page is social proof rather than recruiting contributors, the star should lead instead.

The comparison table is ruled horizontally only and its cells start at the
measure with no left padding, but Infima's defaults were still supplying a
1px border on all four sides of every cell plus zebra striping. The result
was a bordered grid the design never asked for, with the text jammed against
the vertical rules.

Reset the borders, row backgrounds and display so border-collapse applies.
The tag trailed the title inline, so it landed wherever each title happened
to stop and the four sat at four different offsets. Give it its own column
so they line up down the strip, and fall back to the inline treatment on a
phone, where the rows go full width and there is nothing to line up against.
The block promoted four links as equally weighted buttons, so nothing in it
was ranked, and the loudest element was a star. Its own copy says a bug
report is worth more than a star, so the layout was arguing against the
text; starring is also not contributing.

Give it one button, the good-first-issue list, and drop the rest to plain
text running from the ask that takes real work down to the one that costs
nothing. Promote the label to a heading, and caption the contributor row,
which otherwise loses its label to that heading and reads as decoration.
Four clauses and forty-four words wrapped the announcement strip onto two
lines, which is more than a banner gets read for. Keep the two things the
tool is for and drop the rest, which the page it links to already covers.
@sonarqubecloud

sonarqubecloud Bot commented Sep 2, 2026

Copy link
Copy Markdown

❌ The last analysis has failed.

See analysis details on SonarQube Cloud

@codecov

codecov Bot commented Sep 2, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@Akshat0694
Akshat0694 merged commit ca11474 into docs/promote-landing-pages Sep 2, 2026
18 of 19 checks passed
@Akshat0694
Akshat0694 deleted the fix/landing-table-and-roadmap-badge branch September 2, 2026 19:48
Akshat0694 added a commit that referenced this pull request Sep 3, 2026
* docs: promote the new landing pages to the published site

The pages built in tirith-internal as an isolated preview under
documentation/new-landing-page/ become documentation/ itself, replacing the
single-page landing site. Only documentation/ is built by deploy_docs.yml, so
this is what makes them the published site rather than a preview nothing runs.

The preview read the real site across a folder boundary. Those paths are now the
site's own: staticDirectories drops to the default single root with the brand
assets moved into documentation/static/img/, and the docs preset takes ./docs
and ./sidebars.js directly rather than ../docs and ../sidebars.js.

Five pages, replacing one: the landing page, Learn with the browser playground,
Skills, At scale (the commercial page, previously Fleet), and the logo page
reachable only from the landing footer.

The Skills page instructs a reader to curl .claude/skills/tirith-policies/ and
.cursor/rules/tirith-policies.mdc from this repository's main branch, and every
file it lists links into that folder. Neither existed here, so the page shipped
install instructions that 404. The skill pack is self-contained and meant to be
copied into any project, so it moves here with the page that advertises it.

docs/Tirith Logo.html comes across for the same reason: brand/README.md links to
it as the source of truth for the mark's geometry, and three source files cite
it. Its relative link is repointed for the shallower location.

Also brings the public documentation the pages link to: editor-and-local.md, a
link target the build would otherwise reject under onBrokenLinks: 'throw', plus
the Bitbucket, Jenkins and pre-commit CI sections, the 1.2.0 install pins, and
the issue-template links.

deploy_docs.yml gains the PostHog and HubSpot environment. Every value is
optional and unset means the analytics script never loads and the At scale form
disables itself and says why -- which is the right behaviour on a fork.

The documentation README was the stock Docusaurus scaffold telling readers to
use yarn, which is wrong: package-lock.json is the committed lockfile and both
docs workflows say so. It now describes the pages, the environment, the brand
assets and the playground's documented limits.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* docs: keep the stray yarn.lock out of the site folder

The preview folder carried this rule in its own .gitignore; promoting it into
documentation/ kept that folder's .gitignore, not the preview's, so the rule was
lost. A `docusaurus start` then wrote a 352KB yarn.lock into documentation/,
untracked and one `git add -A` away from being committed.

That matters more than a stray file: package-lock.json is the committed
lockfile, both docs workflows run `npm ci`, and a yarn.lock beside it invites
exactly the resolve-fresh install the workflow comments warn against.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* Add documentation for Tirith and update TUI banner text

- Introduced llms.txt for comprehensive documentation on Tirith, covering installation, usage, policy writing, and integration.
- Added a robots.txt file to manage crawler access and document intended policies.
- Updated TUI banner and subtitle to reflect "Open-source IaC governance" instead of "Policy as Code".

* Update banner text in app.py to reflect new branding

* docs: update SKILL.md, debug-ci.md, install.md, pipelines.md, schema.md, validate.md, verdicts.md, and tirith-policies.mdc for clarity and accuracy

* docs: enhance documentation for Tirith policies, including exit codes, validation methods, and pipeline integration

* fix: clean up whitespace and formatting in generate-llms-full.py

* feat: add contributor generation script and update contributor data in documentation

* docs: update logo alt text for accessibility and improve button styles in roadmap

* docs: update analytics configuration and remove deprecated HubSpot form references

* Fix landing page table and roadmap tags, lead Get involved with contribution (#289)

* fix: clear Infima's default table styling from the at-scale comparison

The comparison table is ruled horizontally only and its cells start at the
measure with no left padding, but Infima's defaults were still supplying a
1px border on all four sides of every cell plus zebra striping. The result
was a bordered grid the design never asked for, with the text jammed against
the vertical rules.

Reset the borders, row backgrounds and display so border-collapse applies.

* fix: align the status tags in the home page roadmap strip

The tag trailed the title inline, so it landed wherever each title happened
to stop and the four sat at four different offsets. Give it its own column
so they line up down the strip, and fall back to the inline treatment on a
phone, where the rows go full width and there is nothing to line up against.

* style: lead the get involved block with contribution, not the star

The block promoted four links as equally weighted buttons, so nothing in it
was ranked, and the loudest element was a star. Its own copy says a bug
report is worth more than a star, so the layout was arguing against the
text; starring is also not contributing.

Give it one button, the good-first-issue list, and drop the rest to plain
text running from the ask that takes real work down to the one that costs
nothing. Promote the label to a heading, and caption the contributor row,
which otherwise loses its label to that heading and reads as decoration.

* docs: cut the tirith ui banner to one line

Four clauses and forty-four words wrapped the announcement strip onto two
lines, which is more than a banner gets read for. Keep the two things the
tool is for and drop the rest, which the page it links to already covers.

---------

Co-authored-by: Larison Carvalho <larisoncarvalho@gmail.com>
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants