Add comprehensive GitHub Copilot instructions for lecture-python.myst repository

[Copilot]

This PR creates a comprehensive .github/copilot-instructions.md file that provides GitHub Copilot with detailed instructions on how to work effectively in the lecture-python.myst codebase.

What's Included

The instructions provide complete guidance for:

Environment Setup

• Conda environment creation with exact timing expectations (~3 minutes)
• PyTorch installation with CUDA support (~3 minutes)
• JAX and NumPyro installation with specific versions (~30 seconds)
• Environment validation commands to verify correct setup

Build System

• HTML build commands with 45-60 minute timing expectations
• PDF build via LaTeX with 30-45 minute timing expectations
• Jupyter notebook generation with 30-45 minute timing expectations
• Critical "NEVER CANCEL" warnings with appropriate timeout values (60-90+ minutes)

Project Architecture

• Detailed explanation of the Jupyter Book + MyST markdown system
• 80+ economics lecture files structure and organization
• Build output directories and caching system explanation
• Multiple output formats: HTML website, PDF documents, downloadable notebooks

Validation & Testing

• JAX installation testing with expected CPU-mode warnings
• Build verification steps to ensure changes work correctly
• Content validation scenarios for manual testing
• Environment verification commands to check dependencies

Common Issues & Workarounds

• Network access limitations in sandboxed environments (intersphinx warnings expected)
• GPU vs CPU mode behavior for JAX (CPU mode is normal and functional)
• Build caching system to speed up subsequent builds
• Debugger warnings during notebook execution (normal behavior)

Validation Performed

All commands and instructions have been exhaustively tested and validated:

✅ Environment setup - All installation commands tested with timing measurements
✅ Build commands - HTML, PDF, and notebook builds verified working
✅ Caching system - Confirmed faster subsequent builds using cached notebooks
✅ Validation commands - All verification steps tested and working
✅ Error scenarios - Known warnings and limitations documented with examples

The instructions follow an imperative tone as requested ("Run this command", "Do not do this") and include specific timeout recommendations to prevent premature cancellation of long-running builds.

Fixes #514.

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:

• cdnjs.cloudflare.com
  • Triggering command: /usr/share/miniconda/envs/quantecon/lib/orca_app/orca --no-sandbox -p --plotly --graph-only --mathjax serve 32781 /usr/share/miniconda/envs/quantecon/lib/python3.12/site-packages/plotly/package_data/plotly.min.js REDACTED (dns block)
• intro.quantecon.org
  • Triggering command: /usr/share/miniconda/envs/quantecon/bin/python /usr/share/miniconda/envs/quantecon/bin/jb build lectures --path-output ./ -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)
• python-advanced.quantecon.org
  • Triggering command: /usr/share/miniconda/envs/quantecon/bin/python /usr/share/miniconda/envs/quantecon/bin/jb build lectures --path-output ./ -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://689a96f60335ffacaa00196d--nostalgic-wright-5fa355.netlify.app