Session Kit: Module 21: Reproducibility and FAIR Principles in Connectomics
Everything needed to run Module 21 as a taught session: prep, timing, materials, misconceptions, rubric.
Generated from modules/module21.md. Edit the module page, not this file.
At a glance
| Duration | 4-5 hours |
| Capability target | Publish a reproducibility-ready connectomics package (data + methods + metadata + limitations) that an external group can audit and reuse. |
| Learners leave with | FAIR metadata form |
Before you walk in
- You can state the capability target in one sentence without reading it.
- You have one worked example you will narrate, including where you are unsure.
- Data access works — accounts, viewer, notebook — verified today, not last week.
- The rubric is visible to learners before they start, not after.
- You have decided what “uncertain” earns, and you will say so out loud.
Learners should arrive having covered:
- Basic data-processing workflow familiarity
- Basic manuscript methods section familiarity
Materials
Run of show
| Time | Segment | Your note |
|---|---|---|
| 00:00-06:00 | Framing: the silent bug | |
| 06:00-16:00 | The five-element checklist, modelled | |
| 16:00-30:00 | Guided practice: audit your own work | |
| 30:00-40:00 | Clean-environment rerun | |
| 40:00-50:00 | Known limitations, written honestly | |
| 50:00-57:00 | Competency check | |
| 57:00-60:00 | Exit ticket |
The activity
Scenario: Your lab plans to release a connectomics analysis package to collaborators.
- Build a FAIR metadata sheet for one analysis output.
- Create a reproducibility checklist with pass/fail criteria.
- Draft a “known limitations” section and one deprecation note.
- Peer-test another team’s package for reuse friction.
What learners hand in
- FAIR metadata form
- Reproducibility checklist + validation log
- Reuse friction report with remediation recommendations
Misconceptions to target
These are the errors this session exists to prevent. Surface them in the debrief rather than pre-empting them in the lecture — a misconception a learner has voiced is far easier to correct than one they are holding silently.
- They may believe: Posting files online is not enough.
- Surface it by asking: “What would have to be true for that to hold? What would change your mind?”
- They may believe: A notebook that runs once does not guarantee robust science.
- Surface it by asking: “What would have to be true for that to hold? What would change your mind?”
- They may believe: Learners should not be penalized for norms that were never made explicit.
- Surface it by asking: “What would have to be true for that to hold? What would change your mind?”
Naming the norm
Every session is a chance to make one piece of the hidden curriculum explicit. Pick a moment where you would normally just do the professional thing, and say out loud why you are doing it — then ask whether anyone was taught that.
For this session, the candidate is whichever norm the activity most depends on: stating an assumption in the same sentence as the claim, recording the version a number came from, or saying “uncertain” and having it count as a real answer. See the hidden curriculum for the collected set and why naming them is a fairness intervention rather than etiquette.
Assessment
- Minimum pass
- Strong performance
- Common failure modes
Grade the reasoning, not the answer. A correct call with no evidence chain should not outscore a well-reasoned incorrect one — and saying so publicly changes behaviour within one session.
Exit prompt
Take one prior analysis output and add:
- provenance metadata,
- reproducibility instructions,
- a 5-line limitations section.
If this session goes wrong
- Nobody talks in the debrief. You asked “any questions?” Ask instead: “Which cue would you drop first if the data got worse?”
- Everyone finishes early. They are pattern-matching, not judging. Give an ambiguous case where the answer is “uncertain” and see what happens.
- Nobody finishes. The scaffolding came off too fast. Work the next case together rather than pressing on.
- A learner is silently lost. The most likely cause is unstated vocabulary. Point them at the dictionary and check back.