Fix GitHub Pages configuration for architect theme

[ncipollina]

Problem

GitHub Pages build was failing due to incorrect theme configuration. The theme: architect format doesn't work with GitHub Pages - it requires the remote_theme format.

Solution

Updated the Jekyll configuration to use the proper GitHub Pages theme format and enhanced the styling.

GitHub Pages Theme Fix

• ✅ Change from theme: architect to remote_theme: pages-themes/architect@v0.2.0
• ✅ Add jekyll-remote-theme plugin for proper theme loading
• ✅ Follow official GitHub Pages theme documentation

Enhanced Theme Configuration

• ✅ Add show_downloads: true to enable GitHub repository download links
• ✅ Add google_analytics placeholder for future analytics setup
• ✅ Clean up unnecessary navigation and collections configuration
• ✅ Streamline Jekyll configuration for better performance

Custom Styling

• ✅ Create docs/assets/css/style.scss with custom styles
• ✅ Improve code blocks, tables, and navigation styling
• ✅ Add custom alert boxes and better typography
• ✅ Enhance documentation-specific appearance

Solution Structure

• ✅ Add new CSS file to Visual Studio solution for easy editing
• ✅ Maintain organized documentation structure in IDE

Test Plan

• Verify GitHub Pages builds successfully after merge
• Check that architect theme is properly applied
• Confirm custom styling works correctly
• Test documentation site at https://layeredcraft.github.io/cdk-constructs/

Expected Outcome

• GitHub Pages will build successfully with the architect theme
• Documentation will have a professional, technical appearance
• Custom styling will enhance readability and navigation
• Repository download links will be available in the theme header

References

• GitHub Pages Architect Theme Documentation
• Jekyll Remote Theme Plugin

🤖 Generated with Claude Code

[Copilot]

Pull Request Overview

This PR fixes the GitHub Pages build by switching to the supported remote theme format and adds custom documentation styling.

• Replace theme: architect with remote_theme: pages-themes/architect@v0.2.0 and add the required plugin
• Add docs/assets/css/style.scss for improved code blocks, tables, navigation, alerts, and typography
• Include the new stylesheet in the Visual Studio solution

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
docs/_config.yml	Swapped theme for remote_theme, added jekyll-remote-theme and other site settings
docs/assets/css/style.scss	New SCSS file with empty front matter and extensive custom styles
LayeredCraft.Cdk.Constructs.sln	Added docs\assets\css\style.scss to solution items

Comments suppressed due to low confidence (4)

docs/assets/css/style.scss:1

• [nitpick] The empty front matter (--- lines) is needed so Jekyll will process this SCSS file. Consider adding a brief comment explaining its purpose to avoid confusion.

---

docs/_config.yml:8

• [nitpick] Leaving this key with no value may trigger warnings during build. You can comment it out or set a placeholder string until you have a real tracking ID.

google_analytics: # Add your tracking ID if needed

docs/_config.yml:16

• Make sure to add gem 'jekyll-remote-theme' to your Gemfile so that Jekyll can load this plugin; otherwise the remote_theme setting won’t be applied.

  - jekyll-remote-theme

docs/assets/css/style.scss:4

• [nitpick] Verify that site.theme is still defined when using remote_theme. If not, consider importing the theme’s main stylesheet explicitly or using the path from the remote theme package.

@import "{{ site.theme }}";