docs: reorganize job assignment tables and add headcount column - #39
Merged
Merged
Conversation
…h' and 'Department Service' categories.
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
requested review from
Eliza-Diggins
and
a lite review from Copilot
August 28, 2026 14:12
Eliza-Diggins
approved these changes
Aug 28, 2026
Eliza-Diggins
left a comment
Member
There was a problem hiding this comment.
Awesome! This is great!
Contributor
There was a problem hiding this comment.
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.rsttables (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.bibreferenced byconf.py). - Renames an avatar substitution (
EmikoGardiner) and adds.claudeto.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: | |||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
📌 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
📚 What Changed
New
#column on every assignment tableRole and People, instead of the count being tacked onto the role name.
a total (
2), a range (0-1), or leads + members (1+3).35 / 8 / 57so the People column has room for thelonger name lists.
Table reorganization
Outreach & Servicessplit intoOutreachandDepartment Service.Social Justiceretired; its one active role moved toDepartment Service.FuntoDepartment Service;Social Hour Coordinator moved from
FuntoTalks, Teas, & Get-Togethers.Roles removed (deliberate — these are no longer tracked as assignments)
Roles renamed
TAZTE / TAFT→TAFTRespect is Part of Research Rep; Facilitators→Respect is Part of Research FacilitatorsQueer Grads Coordinator/s→Queer Grads Social Coordinator/sFixes
Department Servicetable was missing its header row, so its first datarow was rendering as the table header.
|EmikoGardner|image substitution was missing the "i" in Gardiner. Renamedthe definition in
_people.rstand all three usages together. Nothing renderedincorrectly before — the display names and GitHub links were already right.
.. _label:targets and their section titles in14 files, clearing 14
Explicit markup ends without a blank linewarnings.docs_bib.bibthatconf.py'sbibtex_bibfileshas always pointedat 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
✅ Checklist
sphinx-build) or verified it renders correctly💬 Notes for Reviewers (optional)
Headcounts are targets, not current staffing. The
#column says how manypeople 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.