Add custom logging documentation to advanced tutorial#40
Merged
HeyItsGilbert merged 5 commits intomainfrom Feb 10, 2026
Merged
Conversation
Covers overriding individual message type handlers and replacing the entire output routing logic via psake-config.ps1. https://claude.ai/code/session_0184Z4DLZ8Db72rkpca4kQwP
Explains how psake discovers and loads the config file, lists all available configuration properties, and links to the custom logging doc for output handler details. https://claude.ai/code/session_0184Z4DLZ8Db72rkpca4kQwP
✅ Deploy Preview for psake ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
- 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
The previous intro stated psake had no way to log errors to a file, which is no longer true with the outputHandlers feature. Updated to describe the default behavior and link to the custom logging doc. https://claude.ai/code/session_0184Z4DLZ8Db72rkpca4kQwP
There was a problem hiding this comment.
Pull request overview
This PR adds comprehensive documentation for psake's custom logging capabilities, enabling users to integrate their own logging systems with psake's build process. The documentation is well-structured and provides clear guidance on both fine-grained control of individual message types and complete replacement of the logging system.
Changes:
- Added
docs/tutorial-advanced/custom-logging.mdwith detailed instructions for overriding psake's output handlers - Added
docs/tutorial-advanced/psake-config.mddocumenting the psake configuration file structure and all available properties - Updated
docs/tutorial-advanced/logging-errors.mdto reference the new custom logging documentation and clarify the default error handling behavior - Updated
sidebars.tsto include both new documentation pages in the Advanced Techniques section
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| sidebars.ts | Added two new entries (custom-logging and psake-config) to the Advanced Techniques section of the guides sidebar |
| docs/tutorial-advanced/custom-logging.md | New documentation explaining how to override psake's output handlers, including examples for specific message types and full logging replacement |
| docs/tutorial-advanced/psake-config.md | New documentation describing the psake-config.ps1 file structure, all configuration properties, and practical examples for common scenarios |
| docs/tutorial-advanced/logging-errors.md | Updated to clarify default error logging behavior and reference the new custom logging documentation |
tablackburn
approved these changes
Feb 1, 2026
tablackburn
left a comment
tablackburn
left a comment
There was a problem hiding this comment.
Looks good. Address the Copilot comments before merging though.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds comprehensive documentation for psake's custom logging capabilities, enabling users to integrate their own logging systems with psake's build process.
Changes
New documentation: Added
docs/tutorial-advanced/custom-logging.mdcovering:Updated navigation: Added the new custom logging page to the advanced tutorial section in
sidebars.tsImplementation Details
The documentation explains two levels of customization:
heading,default,debug,warning,error,success) via$config.outputHandlers$config.outputHandlerfor full control over message handlingEach approach is documented with clear examples showing how to implement common scenarios like file logging and message suppression.
https://claude.ai/code/session_0184Z4DLZ8Db72rkpca4kQwP