Estimated reading time: 1 minute
Page Improvements
- Improve Page Polish content, structure, and presentation of this page
- Expand Page Add depth, examples, and missing sections to this page
- Update Page Refresh outdated content, versions, links, and screenshots
- Fix Page Issue Report a typo, broken link, layout glitch, or content bug
- SEO Optimize Improve discoverability, metadata, and structured data
- Accessibility Audit Audit this page for WCAG 2.1 AA compliance
Site Improvements
- UI/UX Improvement Propose a design or UX refinement for the theme
- New Feature Propose a new site-wide feature or capability
- Component Enhancement Improve a Jekyll layout, include, or shared component
- Performance Optimization Improve load time, Core Web Vitals, and asset delivery
Table of Contents
SCHEMA — images
Site imagery — identity art referenced from _config.yml, plus subdirectories for avatars, docs screenshots, and generated preview banners.
Structure
| entry | kind | purpose | rules |
|---|---|---|---|
authors/ |
dir | Author avatar images keyed from _data/authors.yml | |
docs/ |
dir | Screenshots embedded in _docs/ pages | |
kb/ |
dir | Images belonging to a knowledge base under _kb/, one folder per knowledge base | |
previews/ |
dir | AI preview banners generated by bundle exec jekyll preview-images (zer0-image-generator gem) — never hand-edit |
generated |
quickstart/ |
dir | Screenshots for the getting-started quick-start guide | |
favicon_gpt_computer_retro.png |
file | Fallback card/OG teaser image (_config.yml teaser) |
|
gravatar-small.png |
file | Navbar branding logo and default author avatar (_config.yml logo) |
|
info-banner-mountain-wizard.png |
file | Intro hero fallback banner (_config.yml info_banner) |
|
wizard-on-journey.png |
file | Wizard illustration embedded by showcase posts |
Placement
- Post/doc banner images are generated into
previews/— regenerate, don’t hand-place. - New docs screenshots →
docs/<area>/matching the doc page that embeds them.