Skip to content

docs(website): restructure documentation and add preset indicators#612

Merged
fansenze merged 1 commit intomainfrom
docs/website-restructure-20260407
Apr 8, 2026
Merged

docs(website): restructure documentation and add preset indicators#612
fansenze merged 1 commit intomainfrom
docs/website-restructure-20260407

Conversation

@fansenze
Copy link
Copy Markdown
Contributor

@fansenze fansenze commented Apr 7, 2026

Summary

  • Guide section split: Extracted VSCode Extension, CI Integration, Output Formats, and Environment Variables from Getting Started and CLI Reference into dedicated pages. Reordered sidebar as: Getting Started → VSCode Extension → Type Checking → Inline Directives → CLI Reference → Output Formats → CI Integration → Environment Variables.
  • Configuration section split: Extracted Rules & Presets and Ignoring Files from the monolithic Configuration page into separate sub-pages with cross-references.
  • Preset indicators: Added preset metadata to the rule manifest by importing @rslint/core configs directly. Rules overview table now has a Preset column with filter support. Individual rule detail pages show a preset table with the configured value (e.g. ts.configs.recommended"error").
  • URL sync: All Rules overview filters (search, group, status, preset) are synced to URL query params for shareable links. Preset table in Rules & Presets page links to filtered Rules overview via "View rules →".
  • CLI cross-references: Options table now links --format, --no-color, --force-color to their respective detail pages.

Related Links

N/A

Checklist

  • Tests updated (or not required).
  • Documentation updated (or not required).

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request significantly restructures the documentation by splitting the configuration and guide sections into multiple dedicated pages, such as 'Ignoring Files', 'Rules & Presets', 'CI Integration', and 'VSCode Extension'. It also enhances the rule manifest generation script to include preset information and updates the documentation theme to display these presets and support URL-based filtering for the rule implementation status. Feedback was provided regarding a missing error check during a file write operation and a redundant optional chaining check where the property is already guaranteed by the type definition.

Comment thread website/plugin-rule-manifest.ts
Comment thread website/theme/components/RuleStates/rule.tsx
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Apr 7, 2026

Deploying rslint with  Cloudflare Pages  Cloudflare Pages

Latest commit: f5fb7fb
Status: ✅  Deploy successful!
Preview URL: https://b5bd32ae.rslint.pages.dev
Branch Preview URL: https://docs-website-restructure-202.rslint.pages.dev

View logs

@fansenze fansenze force-pushed the docs/website-restructure-20260407 branch from cc99585 to 04ca6c9 Compare April 8, 2026 04:52
- Split Guide section: extract VSCode Extension, CI Integration, Output Formats, Environment Variables into separate pages
- Split Configuration section: extract Rules & Presets and Ignoring Files into dedicated pages
- Reorder Guide sidebar: Getting Started → VSCode Extension → Features → CLI Reference sections
- Add preset indicators to rule manifest via @rslint/core import
- Add preset filter with URL sync to Rules overview table
- Add preset table with configured values to individual rule detail pages
- Add cross-reference links between CLI options and their detail pages
- Add "View rules →" links from preset table to filtered Rules overview
@fansenze fansenze force-pushed the docs/website-restructure-20260407 branch from 04ca6c9 to f5fb7fb Compare April 8, 2026 05:17
Copy link
Copy Markdown
Contributor

@simplyme0823 simplyme0823 left a comment

Choose a reason for hiding this comment

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

LGTM

@fansenze fansenze merged commit 70161f3 into main Apr 8, 2026
10 checks passed
@fansenze fansenze deleted the docs/website-restructure-20260407 branch April 8, 2026 05:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants