Skip to content

docs: reorganize job assignment tables and add headcount column - #39

Merged
Eliza-Diggins merged 10 commits into
mainfrom
jobs-table
Aug 28, 2026
Merged

Eliza-Diggins merged 10 commits into
mainfrom
jobs-table

Conversation

@emikogardiner

Copy link
Copy Markdown
Contributor

📌 Summary

Reorganizes the Current Job Assignments tables on the Grad Jobs page and adds a
headcount column so it's clear how many people each role calls for. Splits the old
"Outreach & Services" table into separate "Outreach" and "Department Service"
tables, retires the "Social Justice" table, and clears every Sphinx build warning
in the repo along the way.


🔗 Related Issues (if any)


🧪 Type of Contribution

  • New page or major addition
  • Small content addition or clarification
  • Fixes outdated or incorrect information
  • Typos / formatting / cleanup
  • Structural changes (reorganization, navigation)
  • Other (please describe below)

📚 What Changed

New # column on every assignment table

  • Each role now shows how many people it calls for, in a narrow column between
    Role and People, instead of the count being tacked onto the role name.
  • Values take three forms, explained in a footnote below the last table:
    a total (2), a range (0-1), or leads + members (1+3).
  • Column widths tuned to 35 / 8 / 57 so the People column has room for the
    longer name lists.

Table reorganization

  • Outreach & Services split into Outreach and Department Service.
  • Social Justice retired; its one active role moved to Department Service.
  • T-shirts and Grad Cabinet Snacks moved from Fun to Department Service;
    Social Hour Coordinator moved from Fun to Talks, Teas, & Get-Togethers.

Roles removed (deliberate — these are no longer tracked as assignments)

  • BADGrads Slack Admins — was listed as "Everyone!", not a real assignment
  • Racial Justice Bookclub — inactive, had no one assigned

Roles renamed

  • TAZTE / TAFTTAFT
  • Respect is Part of Research Rep; FacilitatorsRespect is Part of Research Facilitators
  • Queer Grads Coordinator/sQueer Grads Social Coordinator/s

Fixes

  • The Department Service table was missing its header row, so its first data
    row was rendering as the table header.
  • The |EmikoGardner| image substitution was missing the "i" in Gardiner. Renamed
    the definition in _people.rst and all three usages together. Nothing rendered
    incorrectly before — the display names and GitHub links were already right.
  • Added the blank line between .. _label: targets and their section titles in
    14 files, clearing 14 Explicit markup ends without a blank line warnings.
  • Added the docs_bib.bib that conf.py's bibtex_bibfiles has always pointed
    at but which was never committed. It's empty; no page uses :cite: yet.

The build now completes with zero warnings (it previously emitted 15).


🔍 Visibility & Sensitivity Check

  • This content is appropriate for a publicly accessible wiki
  • No private, sensitive, or confidential information is included
  • I'm comfortable with future grads (and the public) reading this

✅ Checklist

  • I built the documentation locally (sphinx-build) or verified it renders correctly
  • Links and references work as expected
  • Content is written with future students in mind
  • I grouped related changes into this single pull request

💬 Notes for Reviewers (optional)

Headcounts are targets, not current staffing. The # column says how many
people a role should have; the People column says who's in it now. They won't
always match, and that's expected — assignments are being redone at the upcoming
meeting.

Some counts are still open. Four roles carry ? (Outreach Coordinator,
Astro Night Coordinator, Queer Grads Social Coordinator/s, AstroCDS) and five have
a blank cell (Grad Cabinet Snacks, Movie Night, Ski Trip, Sierra Conference,
Board Game Night). These get filled in at the assignment meeting — happy to hold
the PR for that if reviewers would rather not merge placeholders.

Feedback especially welcome on the Outreach vs. Department Service split, and
on whether any moved role landed in the wrong table.

emikogardiner and others added 10 commits August 27, 2026 20:58
Move the headcount out of the role names into its own column between
Role and People, across all five assignment tables. Header cells are
marked "Needed*" with a legend below the last table explaining the
total / range / leads+members forms.

Also adds the missing header row to the Department Service table,
which was promoting its first data row into the table header.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The image substitution was defined and used as |EmikoGardner|, missing
the "i" in Gardiner. Renames the definition in _people.rst and all
three usages in the grad jobs table together, so the substitution stays
resolvable. Display names and GitHub URLs were already correct, so
nothing rendered incorrectly.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Each of these files had a `.. _label:` target butted directly against
the title overline, which docutils reports as "Explicit markup ends
without a blank line; unexpected unindent" — 14 warnings in total.

Inserting the blank line resolves them while keeping each label
attached to its section, so every :ref: target still resolves.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
conf.py has always set bibtex_bibfiles = ["docs_bib.bib"], but the file
was never committed, so every build warned that it could not be opened.

No page currently uses :cite: or the bibliography directive, so the file
is empty. If bibliography support isn't wanted, the alternative fix is
dropping sphinxcontrib.bibtex from conf.py instead.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@Eliza-Diggins
Eliza-Diggins requested review from Eliza-Diggins and a lite review from Copilot August 28, 2026 14:12

@Eliza-Diggins Eliza-Diggins left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome! This is great!

@Eliza-Diggins
Eliza-Diggins merged commit 5e03a31 into main Aug 28, 2026
1 check passed
@Eliza-Diggins
Eliza-Diggins deleted the jobs-table branch August 28, 2026 14:19

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Grad Jobs documentation by reorganizing the “Current Job Assignments” tables and adding a dedicated headcount (#) column, while also performing doc hygiene changes intended to eliminate Sphinx warnings (label spacing, missing bib file, and a people-image substitution rename).

Changes:

  • Reworks wiki/source/grad_jobs/index.rst tables (new headcount column; split “Outreach & Services” into “Outreach” + “Department Service”; retire “Social Justice”; move/rename several roles).
  • Fixes/cleans doc build issues (adds blank lines after RST targets in many pages; adds the missing docs_bib.bib referenced by conf.py).
  • Renames an avatar substitution (EmikoGardiner) and adds .claude to .gitignore.

Reviewed changes

Copilot reviewed 17 out of 18 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
wiki/source/teaching/accessible_latex_guide.rst Adds blank line after label (RST warning cleanup).
wiki/source/program/fellowships.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/undergrad_liaison.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/UAW2865.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/small_council.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/prospective_visit.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/projectionists.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/outreach/index.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/mps_375.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/movie_night.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/mentoring.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/index.rst Main reorganization: headcount column + table restructuring + role moves/renames.
wiki/source/grad_jobs/gsps.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/grad_admissions.rst Adds blank line after label (RST warning cleanup).
wiki/source/grad_jobs/dei_advisors.rst Adds blank line after label (RST warning cleanup).
wiki/source/docs_bib.bib Adds missing BibTeX file referenced by Sphinx config.
wiki/source/_people.rst Renames Emiko avatar substitution to fix spelling (“Gardiner”).
.gitignore Ignores .claude local tooling directory.
Suppressed comments (1)

wiki/source/teaching/accessible_latex_guide.rst:10

  • This GitHub link is missing a URL scheme, so it will render as a relative link (and likely break). Use the full https:// URL.

===========================================
Writing Accessible LaTex Documents
===========================================
- |ElizaDiggins| `Eliza Diggins <github.com/eliza-diggins>`__, Written 01/08/26.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

.. _latex_accessibility:

===========================================
Writing Accessible LaTex Documents
@@ -1,6 +1,7 @@
:show_git_badge: true

.. _undergrade_liaison:
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.

3 participants