Skip to content

Make a TeachNet Page#1

Open
cycomachead wants to merge 7 commits into
mainfrom
cycomachead/1-https-teaching-berkeley-edu-resources-teach-net-take-this-page-and-make-me-a-jekyll-website-suita/1
Open

Make a TeachNet Page#1
cycomachead wants to merge 7 commits into
mainfrom
cycomachead/1-https-teaching-berkeley-edu-resources-teach-net-take-this-page-and-make-me-a-jekyll-website-suita/1

Conversation

@cycomachead

Copy link
Copy Markdown
Contributor

Initialize Berkeley-styled Jekyll site for Teach-Net

Creates a complete GitHub Pages–ready Jekyll site for Teach-Net, the UC Berkeley moderated email forum for faculty and staff. The site follows UC Berkeley brand guidelines and is designed to be maintained by non-technical users.

Changes

Content & Pages

  • index.md — Teach-Net home page with subscribe instructions, post address, and reply-all warning callout
  • resources.md — Teaching resources page with links to CTL and campus tools

Modular Includes

  • button.html — drop-in styled link button usable from Markdown
  • callout.html — highlighted note/tip/warning boxes usable from Markdown
  • header.html, nav.html, footer.html, head.html — small, independently editable layout pieces
  • Navigation driven by _data/navigation.yml (add a page to the menu by editing one file)

UC Berkeley Styling

  • SCSS split into four small partials: _variables, _base, _layout, _components
  • Berkeley Blue #002676, Founders Rock #003262, California Gold #FDB515, and brand fonts (Inter / Source Serif 4 / Source Code Pro)

Accessibility

  • Skip link, semantic landmarks, aria-current nav, visible focus rings, WCAG AA contrast
  • axe-core RSpec specs adapted from berkeley-cdss/berkeley-class-site, covering WCAG 2.1 AA and 2.2 per page
  • CI workflow runs accessibility checks on every push and PR; screenshots of failures are uploaded as artifacts

CI & Deployment

  • GitHub Actions workflow builds and deploys to Pages on push to main
  • Separate accessibility workflow with failure summary and screenshot artifacts

Developer Experience

  • Devcontainer with live-reload preview (works in GitHub Codespaces and VS Code)
  • Plain-language README aimed at non-technical maintainers: browser-based editing, Markdown basics, reusable block usage, and one-time Pages setup instructions

Superconductor Ticket Implementation | Guided Review

@cycomachead cycomachead changed the title https://teaching.berkeley.edu/resources/teach-net Take this page, and make me a Jekyll website suitable for GitHub pages that follows a similar be... Make a TeachNet Page Jun 26, 2026
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.

1 participant