Kitchen sink changes (#5040)

* docs: fix typo in contributing image asset and markdown references

* docs: fix typos and grammatical phrasing in documentation

* fix(config): correct typographical errors in tweak and app descriptions

* fix(scripts): resolve typos and grammatical errors in PowerShell sources

* fix: address review feedback on Outlook description, WinUtil capitalization, and grammar

.github/CONTRIBUTING.md

@@ -91,7 +91,7 @@ graph TD
 * Run the following command to compile and run WinUtil:
 * `.\Compile.ps1 -run`
 
-![Compile](/docs/src/assets/contributing/Complie.png)
+![Compile](/docs/src/assets/contributing/Compile.png)
 
 
 Open PowerShell as Administrator.

README.md

@@ -13,7 +13,7 @@ A curated compilation of Windows system tasks streamline **installs**, debloat w
 
 ## Quick Start
 
-> **WinUtil must be run as Administrator** Because it performs system-wide changes.
+> **WinUtil must be run as Administrator** because it performs system-wide changes.
 
 Open PowerShell or Terminal as admin, then run:
 

config/applications.json

@@ -1406,7 +1406,7 @@
       "category": "Document",
       "choco": "qownnotes",
       "content": "QOwnNotes",
-      "description": "QOwnNotes is a free open-source note taking app with Nextcloud/ownCloud integration.",
+      "description": "QOwnNotes is a free open-source note-taking app with Nextcloud/ownCloud integration.",
       "link": "https://www.qownnotes.org/",
       "winget": "pbek.QOwnNotes",
       "foss": true  
@@ -1793,7 +1793,7 @@
         "category": "Communications",
         "choco": "na",
         "content": "Vesktop",
-        "description": "A cross platform electron-based desktop app aiming to give you a snappier Discord experience with Vencord pre-installed.",
+        "description": "A cross-platform electron-based desktop app aiming to give you a snappier Discord experience with Vencord pre-installed.",
         "link": "https://vesktop.dev",
         "winget": "Vencord.Vesktop",
         "foss": true

config/tweaks.json

@@ -854,7 +854,7 @@
   },
   "WPFTweaksEndTaskOnTaskbar": {
     "Content": "End Task With Right Click - Enable",
-    "Description": "Enables option to end task when right clicking a program in the taskbar.",
+    "Description": "Enables option to end task when right-clicking a program in the taskbar.",
     "category": "Essential Tweaks",
     "panel": "1",
     "registry": [
@@ -1385,7 +1385,7 @@
   },
   "WPFToggleNewOutlook": {
     "Content": "Microsoft Outlook New Version",
-    "Description": "This will ensures the classic Outlook application is used.",
+    "Description": "This will ensure the new Outlook application is used.",
     "category": "Customize Preferences",
     "panel": "2",
     "Type": "Toggle",

docs/src/content/docs/code-reference/architecture.mdx

@@ -129,14 +129,14 @@ winutil/
 
 ## Win11 Creator Architecture
 
-The **Win11 Creator** is a specialized subsystem within Winutil that creates customized Windows 11 ISOs. It operates independently from the main package installation and tweak system.
+The **Win11 Creator** is a specialized subsystem within Winutil that creates customized Windows 11 ISOs. It operates independently of the main package installation and tweak system.
 
 ### Win11 Creator Components
 
 **Core Functions** (`functions/private/`):
 - `Invoke-WinUtilISO.ps1`: Main orchestrator containing all Win11 Creator functions
   - `Invoke-WinUtilISOBrowse`: ISO file selection dialog
-  - `Invoke-WinUtilISOMountAndVerify`: Validates and mounts ISO, verifies it's official Windows 11
+  - `Invoke-WinUtilISOMountAndVerify`: Validates and mounts ISO, verifies it is an official Windows 11 ISO
   - `Invoke-WinUtilISOModify`: Launches modification in background runspace
   - `Invoke-WinUtilISOExport`: Handles ISO and USB export
   - `Invoke-WinUtilISOCheckExistingWork`: Recovers incomplete work sessions

docs/src/content/docs/contributing.mdx

@@ -101,7 +101,7 @@ While you can make your changes directly through the Web, we recommend cloning t
 * Run the following command to compile and run WinUtil:
 * `.\Compile.ps1 -run`
 
-![Compile](../../assets/contributing/Complie.png)
+![Compile](../../assets/contributing/Compile.png)
 
 * After seeing that your changes work properly, feel free to commit the changes to the repository and make a PR. For help on that, follow the documentation below.
 

docs/src/content/docs/knownissues.mdx

@@ -9,7 +9,7 @@ If you run WinUtil and get an error like:
 
 `< : The term '<' is not recognized as the name of a cmdlet, function, script file, or operable program.`
 
-try using a **VPN** and if that doesn't work than report the issue to https://github.com/ChrisTitusTech/winutil/issues
+try using a **VPN** and if that doesn't work then report the issue to https://github.com/ChrisTitusTech/winutil/issues
 
 ### Script Won't Run
 
@@ -17,13 +17,13 @@ If you run WinUtil and get the error:
 
 `"WinUtil is unable to run on your system. PowerShell execution is restricted by security policies"`
 
-this means that your PowerShell session is in **Constrained Language Mode**, which prevents WinUtil from running.
+This means that your PowerShell session is in **Constrained Language Mode**, which prevents WinUtil from running.
 
 ### Ultimate Performance Plan Not Working
 
 The Ultimate Performance power plan may not work on some laptops that do not fully support this power plan.
 
-In these cases, the power plan may fail to apply, This is expected behavior on unsupported hardware.
+In these cases, the power plan may fail to apply. This is expected behavior on unsupported hardware.
 
 ### Revert start menu tweak not working
 
@@ -34,7 +34,7 @@ In this update, Microsoft completely removed the old Start Menu code from Window
 ### Issues with PowerShell 7 or Class not registered Error
 Installing PowerShell 7 from the Microsoft Store (MSIX package) is known to cause issues with DISM cmdlets such as `Get-WindowsOptionalFeature` and `Enable-WindowsOptionalFeature`, resulting in a `Class not registered` COM error.
 
-This might also make it so running the "pre-installed app removal" will take a indefinite amount of time
+This might also make it so running the "pre-installed app removal" will take an indefinite amount of time
 
 Instead, install PowerShell 7 using one of the following methods:
 

functions/private/Add-SelectedAppsMenuItem.ps1

@@ -41,7 +41,7 @@ function Add-SelectedAppsMenuItem {
     $selectedAppRemoveButton.Add_MouseEnter({ $this.Foreground = "Red" })
     $selectedAppRemoveButton.Add_MouseLeave({ $this.SetResourceReference([Windows.Controls.Control]::ForegroundProperty, "MainForegroundColor") })
     $selectedAppRemoveButton.Add_Click({
-            $sync.($this.Tag).isChecked = $false # On click of the remove button, we only have to uncheck the corresponding checkbox. This will kick of all necessary changes to update the UI
+            $sync.($this.Tag).isChecked = $false # On click of the remove button, we only have to uncheck the corresponding checkbox. This will kick off all necessary changes to update the UI
     })
     [System.Windows.Controls.Grid]::SetColumn($selectedAppRemoveButton, 1)
     $selectedAppGrid.Children.Add($selectedAppRemoveButton)

functions/private/Initialize-InstallAppArea.ps1

@@ -3,7 +3,7 @@
             .SYNOPSIS
                 Creates a [Windows.Controls.ScrollViewer] containing a [Windows.Controls.ItemsControl] which is setup to use Virtualization to only load the visible elements for performance reasons.
                 This is used as the parent object for all category and app entries on the install tab
-                Used to as part of the Install Tab UI generation
+                Used as part of the Install Tab UI generation
 
             .PARAMETER TargetElement
                 The element to which the AppArea should be added
@@ -13,7 +13,7 @@
         $targetGrid = $sync.Form.FindName($TargetElement)
         $null = $targetGrid.Children.Clear()
 
-        # Create the outer Border for the aren where the apps will be placed
+        # Create the outer Border for the area where the apps will be placed
         $Border = New-Object Windows.Controls.Border
         $Border.VerticalAlignment = "Stretch"
         $Border.SetResourceReference([Windows.Controls.Control]::StyleProperty, "BorderStyle")

functions/private/Reset-WPFCheckBoxes.ps1

@@ -2,7 +2,7 @@ function Reset-WPFCheckBoxes {
     <#
 
     .SYNOPSIS
-        Set winutil checkboxs to match $sync.selected values.
+        Set WinUtil checkboxes to match $sync.selected values.
         Should only need to be run if $sync.selected updated outside of UI (i.e. presets or import)
 
     .PARAMETER doToggles

functions/public/Invoke-WPFUltimatePerformance.ps1

@@ -1,7 +1,7 @@
 function Invoke-WPFUltimatePerformance ([switch]$Enable) {
     if ($Enable) {
         powercfg /setactive (powercfg /duplicatescheme e9a42b02-d5df-448d-aa00-03f14749eb61 | Select-String -Pattern '[A-Fa-f0-9-]{36}').Matches.Value
-        [System.Windows.MessageBox]::Show("Ultimate Power Plan plan installed and activated.","Success","OK","Information")
+        [System.Windows.MessageBox]::Show("Ultimate Power Plan installed and activated.","Success","OK","Information")
     } else {
         powercfg /restoredefaultschemes
         [System.Windows.MessageBox]::Show("Power Plan was reset to defaults.","Success","OK","Information")

scripts/main.ps1

@@ -37,7 +37,7 @@ $sync.preferences.packagemanager = "Winget"
 if ($Preset) {
     Initialize-WinUtilRunspacePool | Out-Null
 
-    # Selects the tweaks from $Preset varible
+    # Selects the tweaks from $Preset variable
     Update-WinUtilSelections -flatJson $sync.configs.preset.$Preset
 
     # Run tweaks that were selected by Update-WinUtilSelections
@@ -68,7 +68,7 @@ if ($Config) {
 [xml]$XAML = $inputXML
 
 # Read the XAML file
-$readerOperationSuccessful = $false # There's more cases of failure then success.
+$readerOperationSuccessful = $false # There are more cases of failure than success.
 $reader = (New-Object System.Xml.XmlNodeReader $xaml)
 try {
     $sync["Form"] = [Windows.Markup.XamlReader]::Load( $reader )
@@ -92,7 +92,7 @@ if (-NOT ($readerOperationSuccessful)) {
     exit 1
 }
 
-# Setup the Window to follow listen for windows Theme Change events and update the winutil theme
+# Setup the Window to listen for Windows Theme Change events and update the WinUtil theme
 # throttle logic needed, because windows seems to send more than one theme change event per change
 $lastThemeChangeTime = [datetime]::MinValue
 $debounceInterval = [timespan]::FromSeconds(2)
@@ -319,7 +319,7 @@ $sync["Form"].Add_ContentRendered({
 })
 
 # The SearchBarTimer is used to delay the search operation until the user has stopped typing for a short period
-# This prevents the ui from stuttering when the user types quickly as it dosnt need to update the ui for every keystroke
+# This prevents the ui from stuttering when the user types quickly as it doesn't need to update the ui for every keystroke
 
 $searchBarTimer = New-Object System.Windows.Threading.DispatcherTimer
 $searchBarTimer.Interval = [TimeSpan]::FromMilliseconds(300)