Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Aug 22, 2025

This PR adds a comprehensive .github/copilot-instructions.md file that provides GitHub Copilot coding agents with detailed guidance for working in this Jekyll-based blog repository.

What's Included

The instructions cover all essential aspects of working with this Jekyll site:

  • Bootstrap commands: Complete setup from fresh clone including Ruby/Bundler installation
  • Build & serve commands: All Jekyll commands with proper timeout specifications
  • Validation commands: HTML proofer with correct v5.0.10 syntax
  • Performance data: Actual measured timing data with "NEVER CANCEL" warnings
  • Repository structure: Key directories, file locations, and technologies used
  • Troubleshooting: Common issues and their solutions
  • Manual validation: HTTP testing commands to verify site functionality

Validation Process

Every single command in the instructions has been thoroughly tested and validated:

Bundle install: 27 seconds (119 gems installed)
Jekyll build: 3 seconds (98 HTML files generated)
HTML proofer: 1 second (passes validation)
Jekyll serve: Site accessible at http://localhost:4000
Content verification: Confirmed "solrevdev tech radar" branding

Key Features

  • Imperative tone: All instructions use direct commands ("Run this", "Do not do that")
  • Explicit timeouts: Proper timeout values documented for all long-running operations
  • Working commands: Every command tested from fresh repository state
  • Comprehensive coverage: From initial setup through deployment and troubleshooting
  • Performance notes: Accurate timing data to set proper expectations

The instructions follow the firm directive to "always reference these instructions first and fallback to search or bash commands only when you encounter unexpected information."

Also updated .gitignore to properly exclude vendor/bundle and .bundle directories from version control.

Fixes #5.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 2 commits August 22, 2025 22:55
… and timing

Co-authored-by: solrevdev <374863+solrevdev@users.noreply.github.com>
Co-authored-by: solrevdev <374863+solrevdev@users.noreply.github.com>
Copilot AI changed the title [WIP] ✨ Set up Copilot instructions Add comprehensive GitHub Copilot instructions for Jekyll blog development Aug 22, 2025
Copilot AI requested a review from solrevdev August 22, 2025 22:57
Copilot finished work on behalf of solrevdev August 22, 2025 22:57
@solrevdev
Copy link
Owner

Closes #5 as I'll do this myself from within Visual Studio Code plus I'll add CLAUDE.md, WARP.md and any other AGENT.md style file.

@solrevdev solrevdev closed this Aug 25, 2025
@solrevdev solrevdev deleted the copilot/fix-5 branch August 27, 2025 12:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

✨ Set up Copilot instructions

2 participants