Skip to content

Improve README API documentation consistency and cross-references#3994

Draft
nstepien wants to merge 4 commits intomainfrom
claude/practical-swanson
Draft

Improve README API documentation consistency and cross-references#3994
nstepien wants to merge 4 commits intomainfrom
claude/practical-swanson

Conversation

@nstepien
Copy link
Collaborator

@nstepien nstepien commented Mar 7, 2026

Summary

  • Formatting standardization: Consistent **Default:** format, removed NoInfer<> from doc signatures, added missing periods
  • Missing content: Added onFill description with example, PartialPosition and ColumnWidth type entries, (internal) markers on non-exported types
  • Types reorganization: Reordered the entire Types section into 7 logical groups (Column Types, Render Props, Events, Callbacks, Grid Control, Utility, Internal)
  • Cross-references: Added bidirectional links between all props and their associated types — forward refs from props to types, and "See also" back-refs from types to props
  • Accuracy fixes: Corrected RenderCheckboxProps field optionality, added full interface for CellRendererProps, added missing setActivePosition to RenderRowProps

Test plan

  • Verify all markdown anchor links resolve correctly on GitHub
  • Spot-check cross-references between props and types
  • Verify type definitions match source code in src/types.ts

🤖 Generated with Claude Code

nstepien and others added 4 commits March 7, 2026 01:46
- Standardize **Default:** formatting and remove NoInfer<> from signatures
- Add missing descriptions (onFill, PartialPosition, ColumnWidth) and (internal) markers
- Reorganize Types section into logical groups: Column, Render Props, Events, Callbacks, Grid Control, Utility, Internal
- Add bidirectional cross-references between props and types (forward refs and "See also" back-refs)
- Fix type accuracy: RenderCheckboxProps optionality, CellRendererProps/RenderRowProps completeness

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add missing periods to aria-label and aria-labelledby descriptions
- Add missing description for aria-description prop
- Fix comma splice in rows prop description
- Fix "css" → "CSS" capitalization
- Fix missing articles in onCellClick description
- Add colon after "change the onSortColumnsChange function to"
- Remove unused SelectColumn import from sorting example
- Fix "renderRow prop" → "renderers.renderRow" for consistency

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Fix "css" → "CSS" in Vite warning
- Add missing article: "when a keydown event"
- Fix comma splice in direction prop: "the grid, it" → "the grid. It"
- Fix missing article: "whether the column is frozen"
- Standardize "Triggered" → "Callback triggered" for onActivePositionChange

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Remove inconsistent trailing periods in Features list
- Fix "The rows data" → "Row data" for natural phrasing
- Add missing type imports (Column, SortColumn) in code examples
- Format sortDirection values in inline code backticks
- Add missing article "an" before "indeterminate state"
- Standardize "See also" for ColSpanArgs to use dotted notation
- Improve CalculatedColumn description wording
- Standardize onCellKeyDown description to "Callback triggered" pattern

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@nstepien nstepien self-assigned this Mar 7, 2026
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.

1 participant