Move psake-config doc to Advanced Techniques and clarify scope

- Moved from tutorial-basics to tutorial-advanced since this is an
  uncommon, advanced topic
- Added note that most projects don't need a config file
- Added "Partial Overrides" section explaining that missing properties
  keep their defaults
- Fixed cross-reference links

https://claude.ai/code/session_0184Z4DLZ8Db72rkpca4kQwP

Author: claude

docs/tutorial-advanced/custom-logging.md

@@ -1,6 +1,6 @@
 # Custom Logging
 
-psake routes all internal messages through configurable output handlers. You can override these handlers in your [`psake-config.ps1`](../tutorial-basics/psake-config.md) file to integrate with your own logging system.
+psake routes all internal messages through configurable output handlers. You can override these handlers in your [`psake-config.ps1`](./psake-config.md) file to integrate with your own logging system.
 
 ## Default Handlers
 

docs/tutorial-basics/psake-config.md docs/tutorial-advanced/psake-config.mddocs/tutorial-basics/psake-config.md renamed to docs/tutorial-advanced/psake-config.md

@@ -2,6 +2,10 @@
 
 psake loads a `psake-config.ps1` file at the start of every build to set default values for your build environment. You can use this file to change psake's default build file name, framework version, task name format, output handlers, and more.
 
+:::note
+Most projects do not need a `psake-config.ps1` file. psake's built-in defaults work well for the majority of use cases. Only create one if you need to change a specific default.
+:::
+
 ## How psake Finds the Config File
 
 psake searches for `psake-config.ps1` in two locations, in order:
@@ -13,6 +17,10 @@ The first file found wins. If neither location contains a config file, psake use
 
 This means you can place a `psake-config.ps1` next to your `psakefile.ps1` to customize settings per-project, or place one alongside the psake module for machine-wide defaults.
 
+## Partial Overrides
+
+Your config file does not need to set every property. psake initializes all properties to their defaults before loading your config file, so any property you omit keeps its default value. You only need to set the properties you want to change.
+
 ## Configuration Properties
 
 Inside `psake-config.ps1`, you set properties on the `$config` variable. Here is every available property:
@@ -72,10 +80,10 @@ $config.modules = @(".\modules\*.psm1", ".\my_module.psm1")
 
 ## Output Handlers
 
-psake routes all internal messages through configurable output handlers. For a full guide on customizing logging, see [Custom Logging](../tutorial-advanced/custom-logging.md).
+psake routes all internal messages through configurable output handlers. For a full guide on customizing logging, see [Custom Logging](./custom-logging.md).
 
 ## See Also
 
-- [Custom Logging](../tutorial-advanced/custom-logging.md) — Override psake's output handlers
-- [Configuration Reference](../reference/configuration-reference.md) — Full reference for `Invoke-psake` parameters and build script settings
-- [Structure of a psake Build Script](../tutorial-advanced/structure-of-a-psake-build-script.md) — How build scripts are organized
+- [Custom Logging](./custom-logging.md) — Override psake's output handlers
+- [Configuration Reference](../reference/configuration-reference) — Full reference for `Invoke-psake` parameters and build script settings
+- [Structure of a psake Build Script](./structure-of-a-psake-build-script.md) — How build scripts are organized

sidebars.ts

@@ -20,7 +20,6 @@ const sidebars: SidebarsConfig = {
     'tutorial-basics/run-psake',
     'tutorial-basics/tasks',
     'tutorial-basics/parameters-properties',
-    'tutorial-basics/psake-config',
   ],
 
   // Guides - How-to guides, examples, and best practices
@@ -43,6 +42,7 @@ const sidebars: SidebarsConfig = {
         'tutorial-advanced/build-script-resilience',
         'tutorial-advanced/debug-script',
         'tutorial-advanced/custom-logging',
+        'tutorial-advanced/psake-config',
         'tutorial-advanced/logging-errors',
         'tutorial-advanced/outputs-and-artifacts',
         'tutorial-advanced/print-psake-task-name',