HAAG Faculty Onboarding

This repository is the source for the HAAG Faculty Onboarding site, published with GitHub Pages. It's a second-touch informational site for Georgia Tech faculty considering a research partnership with the Human Augment Analytics Group (HAAG): what HAAG is, what partnering looks like, and the policies that govern it (authorship, researcher management) and programs available (unit meetings).

How the site works

The site is built with Jekyll using the just-the-docs theme, loaded via remote_theme in _config.yml. That approach is necessary because GitHub Pages' automatic build only supports a small whitelist of themes directly, and just-the-docs isn't on it; remote_theme plus the jekyll-remote-theme plugin is GitHub's own supported workaround for using a theme that isn't on that list.

GitHub Pages builds and publishes the site automatically on every push to main. There's no local build step, Gemfile, or bundle install required.

Structure

• index.md: the site's home page (permalink: /)
• policies/: HAAG policies (authorship, researcher management), with policies/index.md as the section's parent page
• programs/: HAAG programs (currently unit meetings), with programs/index.md as the section's parent page

Adding a new page

1. Create a .md file in the appropriate folder.

2. Add front matter at the top:

   ---
   title: Your Page Title
   parent: Policies
   nav_order: 2
   ---
   

   Set parent to Policies or Programs to nest it in the sidebar under that section, or omit it for a top-level page. nav_order controls its position among its siblings.

3. Push to main. GitHub Pages rebuilds automatically, and the page appears in the sidebar.