Repository Instructions

Repository Instructions

This repository is a personal academic website deployed through GitHub Pages. It uses AcademicPages / Minimal Mistakes on Jekyll.

Primary Work

  • Prioritize additions and updates for teaching pages and standalone course websites.
  • Preserve the existing AcademicPages structure unless a change is needed for the teaching/course workflow.
  • Keep plans in plan/ as Markdown files with a date prefix, for example plan/YYYY-MM-DD-topic.md.
  • Track work with Git. Check git status --short --branch before and after edits, and keep unrelated local changes intact.

DATA 8020 Course Design

  • courses/data-8020/AGENTS.md is the canonical instruction file for DATA 8020 course design. Read it before working on the syllabus, project handout, lecture notes, slides, computational companions, or the course landing page. The sections below remain the site-level summary and must agree with it.
  • For DATA 8020 course design, lecture planning, and teaching-material development, consult and reuse relevant materials from /Users/dujinhong/Documents/study/HKU/2026 Fall/teaching/DATA 8020 Advanced Causal Inference.
  • Treat that directory as reference material. Do not modify, move, or bulk-copy its contents unless explicitly requested.
  • Continue generating lecture notes for instructor use, but publish only lecture slides on the course website. Publish lecture notes later only if student demand warrants it.

DATA 8020 Slide Convention

  • Keep the slide number at the lower right of every Beamer deck.
  • On each normal content slide, show the current part at the lower left as <number> ยท <short name> in bold HKU green. Use 0 for opening slides, then number the main parts from 1.
  • Keep footer names short and plain. Self-identifying full-page title, section, break, and closing slides may remain footer-free.
  • Use \setfootersection{<number>}{<short name>} immediately before each \section. If a deck has no section commands, place it at each clear topic change without adding divider slides solely for the footer.
  • After changing slide structure or footers, force-build the affected PDFs and visually inspect the opening, one representative slide from each part, and the closing or references.

Instruction Files

  • AGENTS.md is the canonical repository instruction file.
  • Keep CLAUDE.md as a relative symbolic link to AGENTS.md; do not maintain a separate copy that can drift.

Local Build

  • Prefer the existing Ruby/Bundler workflow first:
    • bundle install
    • bundle exec jekyll build
    • bundle exec jekyll serve
  • If the system Ruby setup becomes fragile or incompatible, create a standalone conda environment for local builds rather than changing global tooling.
  • Keep generated site output and dependency directories out of commits unless explicitly requested.
  • Local Bundler installs should use an ignored path such as .bundle/ if global native gems are incompatible.

Site Structure Notes

  • Site configuration lives in _config.yml.
  • Top navigation lives in _data/navigation.yml.
  • Standard pages live in _pages/.
  • Blog-style posts live in _posts/.
  • Existing collection examples include _talks/ and the research collection configuration.
  • _layouts/single.html already contains presentation logic for a future teaching collection, but _config.yml does not currently define that collection.