Epic: Settings UI Completion #6800

written and maintained by Carlos Zamora (@carlos-zamora)

Settings UI Issue: #1564
Settings UI PR: #8048
Settings UI Spec & Design: #6720

Now that it has merged to main, there are a few follow-up items to work on. This scenario tracks follow-up tasks from that PR, and other features we are committing to for Windows Terminal v2.

Features

• Profile/ColorScheme should have an Add/Rename/Delete option
  • PR Add UI for adding, renaming, and deleting a color scheme #8403
• SettingsContainer
  • Implement Settings UI inheritance spec #8269 (tracked in Represent Inheritance in Settings UI #8804 ) PR Represent inheritance in Settings UI #8919
  • Add hyperlinks (navigate to source)
  • Add hyperlinks for read-only pages (i.e. profile generators)
• Terminal Appearance Preview (Add a preview of your terminal to the Settings UI #9122)
  • Embed a TermControl in the "Appearance" tab of a Profile page. This TermControl should update as you make changes to your Profile
  • A similar thing should be done to the ColorSchemes page
• FontFace as a TextBox ComboBox
  • FontFace would be easier to select if it was a ComboBox of supported fonts. The list should only include (or at least denote) monospace fonts.
• "Add a profile" should lead to its own page #9121 "Add a profile" page

Styling

• Custom Enum Ordering (PR Order enum settings according to enum values #8784 )
  • Some enum lists (i.e. Font Weight), are not intuitively ordered.

Tasks

• Document how to add a setting ("AddASetting.md")
• Deduplicate Browse button logic
• Polish TabBase #8452 Polish TabBase
• Remove visibility hacks (i.e. acrylic opacity slider), and use ProfileViewModel instead
• Finalize localization changes for Settings UI #8746: Finalize localization changes (Update tooltips and setting names in SUI #8777)
• Polish Settings UI: Profile page #8764: Polish Profile page
• Polish Settings UI: Color Scheme page #8765: Polish ColorSchemes page
• Add automation properties to Settings UI #8899: Automation Properties
• SUI: Add settings for initalPosition, centerOnLaunch #9075: initialPosition, centerOnLaunch

Bugs

• JSON change --> crash
  • open SUI --> open JSON --> edit retro effects in JSON --> save file --> cry because the app crashed
  • No longer getting a repro on main (6b2ae62). 990e06b 's changes to the refresh mechanism may have fixed this?
• Crash when deleting a profile you just added #8747: delete new profile --> crash
• Crash when deleting a profile you just (un)hid #8748: delete newly (un)hidden profile --> crash
• Renaming a color scheme used by a profile should properly update the profile #8756: Rename color scheme should update profile
• [profiles] What should I do to actually delete these profiles? #13451

Backlog

• Settings UI reformats settings.json in an hard to read way Settings UI reformats settings.json in an hard to read way #8991
• Home Page Add a Home Page to the Settings UI #9120
  • Add a Home page that can present release notes, docs, and any other helpful information for Windows Terminal
• [Feature request] [Settings UI] Import a color scheme from a json file #8639 Import Color Scheme
• Search
  • Add a Settings UI Prototype #7370 has a rough implementation of Search in MainPage.xaml (link)
  • Needs to be localizable
• Detect unsaved changes
  • Update the warning label and Discard/Apply buttons appropriately
  • [Terminal]: 'Save' and 'Discard Changes' button should remain in disabled state until we don't make any changes inside Settings page. #12424