Skip to content

docs: documentation quality improvements#409

Merged
w-ahmad merged 2 commits into
mainfrom
w-ahmad-docs-quality-improvements
Jul 8, 2026
Merged

docs: documentation quality improvements#409
w-ahmad merged 2 commits into
mainfrom
w-ahmad-docs-quality-improvements

Conversation

@w-ahmad

@w-ahmad w-ahmad commented Jul 8, 2026

Copy link
Copy Markdown
Owner

Summary

Polishes the documentation site based on a thorough review of https://w-ahmad.dev/WinUI.TableView/.

Changes

Fix outdated AdvancedCollectionView references

  • AdvancedCollectionView was replaced with a custom internal collection view back in v1.3.0. Updated all references in overview.md, sorting.md, filtering.md, binding-data.md, performance.md, and migration-wct.md to reflect the current implementation.
  • Removed the stale using CommunityToolkit.WinUI.Collections import from the filtering code sample.

Polish Getting Started wording

  • Fixed "Create a New WinUI3" → "Create a new WinUI project"
  • Normalized all step headings to sentence case across both Getting Started pages.

Add Uno Platform notes (getting-started-with-uno.md)

  • New Uno Platform notes section covering: WebAssembly, Desktop (Skia), Android/iOS, binding behavior, keyboard/focus differences, and known limitations per target.

Add column type decision table (column-types.md)

  • New "Choosing a column type" section near the top with a reference table mapping common needs to the recommended column type.

Update WinUI branding

  • Prefer WinUI over WinUI 3 in general descriptions across index.md, overview.md, performance.md, accessibility.md, and aot-compatibility.md.
  • Kept "WinUI 3" where technically specific (e.g. AOT applies to the Windows App SDK / WinUI 3 target specifically).

Fix missing section heading in sorting.md

  • Restored the missing ## Sorting programmatically heading before the SortDescriptions code example.

Not included

  • Recipes page — deferred until screenshots are available for the conditional styling and row details recipes.

w-ahmad and others added 2 commits July 9, 2026 01:58
- Remove outdated AdvancedCollectionView/CommunityToolkit references
  from overview, sorting, filtering, binding-data, performance, and
  migration-wct; replaced with 'internal collection view' wording

- Fix Getting Started headings: 'Create a New WinUI3' -> 'Create a new
  WinUI project'; normalize heading casing throughout

- Add comprehensive Uno Platform notes section to getting-started-with-uno.md
  covering WASM, Desktop (Skia), Android/iOS, binding, focus, and
  known limitations

- Add 'Choosing a column type' decision table at the top of column-types.md

- Create docs/docs/recipes.md with practical how-to recipes:
  read-only table, copy/paste, template column with sort/filter,
  row details, conditional highlighting, custom sort/filter,
  programmatic cell selection, CSV export, and MVVM pattern

- Add Common Recipes to docs TOC

- Update WinUI branding: prefer 'WinUI' over 'WinUI 3' in general
  descriptions; keep 'WinUI 3' only where technically specific

- Fix missing section heading 'Sorting programmatically' in sorting.md

Co-authored-by: Copilot App <[email protected]>
@w-ahmad w-ahmad changed the title docs: documentation quality improvements (ChatGPT review findings) docs: documentation quality improvements Jul 8, 2026
@w-ahmad
w-ahmad merged commit c0fbc70 into main Jul 8, 2026
4 checks passed
@w-ahmad
w-ahmad deleted the w-ahmad-docs-quality-improvements branch July 8, 2026 21:56
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