Add comprehensive GitHub Copilot instructions for Jupyter Book development workflow

[Copilot]

This PR adds a comprehensive .github/copilot-instructions.md file that provides GitHub Copilot with detailed guidance for working effectively in this Jupyter Book repository.

What's Added

The instructions cover the complete development workflow for this QuantEcon Python Programming lecture series repository:

Environment Setup & Build Process:

• Step-by-step conda environment creation (conda env create -f environment.yml)
• All validated build commands with measured timing expectations
• LaTeX dependency installation for PDF generation
• HTML, PDF, and Jupyter notebook build processes

Critical Timing & Timeout Guidance:

• Environment creation: 3 minutes (recommended timeout: 5+ minutes)
• HTML builds: 4+ minutes (recommended timeout: 8+ minutes)
• LaTeX dependencies: 20+ minutes (recommended timeout: 35+ minutes)
• Explicit "NEVER CANCEL" warnings for long-running operations

Manual Validation Requirements:

• HTTP server setup for testing built website functionality
• Navigation testing through lecture links
• Content rendering verification
• Output file validation procedures

Repository Structure & Troubleshooting:

• Complete overview of key directories (/lectures/, /_build/, etc.)
• Common issue explanations (expected warnings, network limitations)
• Build failure recovery procedures
• Performance optimization guidance

Validation

All commands and procedures have been thoroughly tested:

• ✅ Complete environment setup and activation
• ✅ Full HTML build process (4 minutes 20 seconds measured)
• ✅ PDF LaTeX generation with compiled output
• ✅ Jupyter notebook conversion (41 seconds measured)
• ✅ Website functionality verified via HTTP server
• ✅ Navigation and content rendering validated

The built website displays the complete lecture series with proper navigation and styling:

The instructions follow the specified imperative tone ("Run this command", "Do not do that") and prioritize providing exact, working commands over verbose explanations. This enables GitHub Copilot to work efficiently in the codebase without trial-and-error or time-consuming searches.

Fixes #381.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

• esm.ubuntu.com
  • Triggering command: /usr/lib/apt/methods/https (dns block)
• fred.stlouisfed.org
  • Triggering command: /usr/share/miniconda/envs/quantecon/bin/python -Xfrozen_modules=off -m ipykernel_launcher -f /tmp/tmpatezbecg.json --HistoryManager.hist_file=:memory: (dns block)
  • Triggering command: /usr/share/miniconda/envs/quantecon/bin/python -Xfrozen_modules=off -m ipykernel_launcher -f /tmp/tmp20jfo41y.json --HistoryManager.hist_file=:memory: (dns block)
  • Triggering command: /usr/share/miniconda/envs/quantecon/bin/python -Xfrozen_modules=off -m ipykernel_launcher -f /tmp/tmp87yz_uwo.json --HistoryManager.hist_file=:memory: (dns block)
• jax.quantecon.org
  • Triggering command: /usr/share/miniconda/envs/quantecon/bin/python /usr/share/miniconda/envs/quantecon/bin/jb build lectures --path-output ./ -n -W --keep-going (dns block)
  • Triggering command: /usr/share/miniconda/envs/quantecon/bin/python /usr/share/miniconda/envs/quantecon/bin/jb build lectures --builder pdflatex --path-output ./ -n -W --keep-going (dns block)
  • Triggering command: /usr/share/miniconda/envs/quantecon/bin/python /usr/share/miniconda/envs/quantecon/bin/jb build lectures --path-output ./ --builder=custom --custom-builder=jupyter -n -W --keep-going (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[github-actions]

🚀 Deployed on https://689a95e9be5bceaa3dea0c50--epic-agnesi-957267.netlify.app