microsoft / microsoft/WinUI-Gallery

Folder structure: Controls, Design, Accessibility, Fundamentals

Open
#1,744 10 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
C#
Stars
3.6k
Forks
756
Avg merge
17h 51m
Merged PRs (30d)
14

Description

This app used to be named "Control Gallery", but has evolved to encompass many more things. The current folder structure - and some file names - are still, inappropriately, centered on "Controls".

  • 📂 ControlPages > Accessibility, DesignGuidance, Fundamentals
  • File names like "ControlData<Schema>.json" and their content

sub of #1614


Suggested
  • AppControls
  • AppPages
  • Samples
    • SampleCode (level "A")
      • Accessibility (level "B")
      • Design
        • Iconography
        • Geometry
        • Typography
      • Fundamentals
        • Binding
        • Templates
        • XamlResources
        • XamlStyles
      • XamlControls
        • 📄 (many txt files)
    • SampleData
      • 📄 (files like AccessibilityData.json, ControlData.json, DesignData, IconData.json, ...)
    • SamplePages (level "A") (not to be mistaken with the current folder with the same name!)
      • Accessibility
      • Design
        • Iconography
        • Geometry
        • Typography
      • Fundamentals
        • Binding
        • Templates
        • XamlResources
        • XamlStyles
      • XamlControls
        • 📄 (many xaml files)
Also
  • use names📁 "AppControls" and "XamlControls" to prevent any ambiguity.
  • looks like 📁 "SamplePages" isn't used? if not, let's remove it.
  • I want to split ControlInfoData into separate files and code.
  • ... then must update ItemPage.xaml.cs and ControlInfoData.cs for ControlInfoDataItem
  • ... a filename like 📄 "...InfoData" is redundant. Info == Data.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by inventorying the current ControlPages, SamplePages, ControlInfoData files, and related names in ItemPage.xaml.cs and ControlInfoData.cs. Align the folders and filenames with the suggested AppControls, XamlControls, SampleCode, SampleData, and SamplePages structure, remove SamplePages if unused, and update the referenced data and code consistently.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
desktop
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.