Restructure documentation navbar for improved navigation #33
Conversation
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
This commit reorganizes the documentation structure to better utilize the navbar and improve user experience: **Navbar Changes:** - Split single "Tutorial" dropdown into three focused sections: - "Get Started" - Beginner onboarding (6 pages) - "Guides" - How-to guides and examples (21 pages) - "Reference" - Commands, troubleshooting, and lookup materials (20+ pages) **Sidebar Restructuring:** - Created gettingStartedSidebar with essential quick-start content - Created guidesSidebar organized into: - Core Concepts - Advanced Techniques - Build Type Examples - CI/CD Integration - Created referenceSidebar with: - Command Reference (auto-generated) - Reference Materials - Troubleshooting - Code of Conduct **Content Updates:** - Streamlined intro.md (Quick Start page) by replacing detailed documentation guide with focused "Next Steps" section - Updated footer links to reflect new structure - Improved information architecture for faster content discovery **Benefits:** - Command reference now accessible in 2 clicks vs deep sidebar navigation - Clear separation between learning content and lookup content - Reduced cognitive load with focused, purposeful sections - Better SEO through improved content organization - No breaking changes - all URLs remain valid
✅ Deploy Preview for psake ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Set --ifm-background-color to #F8F9F5 for a softer, more pleasant background that reduces eye strain while maintaining readability.
…arameter Updated the Getting Help page to provide comprehensive support resources: - Added "View Available Tasks" section documenting Invoke-psake -Docs parameter for listing tasks in build scripts - Reorganized content into clear sections: Built-in Help, Community Support, and Documentation - Added Community Support section with links to: - PowerShell Discord #psake channel - PowerShell Slack #psake channel - GitHub Discussions - Stack Overflow psake tag - GitHub Issues for bug reports - Improved PowerShell examples with cleaner output formatting - Added cross-references to Command Reference, Troubleshooting, and FAQ - Updated description frontmatter for better SEO
HeyItsGilbert
deleted the
claude/restructure-docs-navbar-012JH3fcyNHUZxgKc9usEg5M
branch
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
This commit reorganizes the documentation structure to better utilize the navbar and improve user experience:
Navbar Changes:
Sidebar Restructuring:
Content Updates:
Benefits: