Module 17: Scientific Writing for Connectomics

Teaching Deck

Learning Objectives

  • Convert connectomics analyses into coherent claim-evidence writing
  • Write figure legends that are reproducible and interpretation-safe
  • Draft abstracts that distinguish result, uncertainty, and limitation
  • Respond to reviewer critiques with technically grounded revisions

Session Outcomes

  • Learners can complete the module capability target.
  • Learners can produce one evidence-backed artifact.
  • Learners can state one limitation or uncertainty.

Agenda (60 min)

  • 0-10 min: Frame and model
  • 10-35 min: Guided practice
  • 35-50 min: Debrief and misconception correction
  • 50-60 min: Competency check + exit ticket

Capability Target

Produce a manuscript-ready results section (figures, legends, and claims) where each conclusion is traceable to explicit connectomics evidence and stated limitations.

Concept Focus

1) Claim-evidence mapping

  • Technical: each claim should map to a figure panel, metric, and method reference.
  • Plain language: no claim without visible evidence.
  • Misconception guardrail: writing stronger language does not strengthen weak evidence.

Core Workflow

  • See module page for details.

60-Minute Run-of-Show

  • See module page for details.

Misconceptions to Watch

  • Misconception guardrail: writing stronger language does not strengthen weak evidence.
  • Misconception guardrail: uncertainty statements are not weakness; they are reproducibility signals.
  • Misconception guardrail: defensive tone weakens technical credibility.

Studio Activity

Activity Output Checklist

  • Evidence-linked artifact submitted.
  • At least one limitation or uncertainty stated.
  • Revision point captured from feedback.

Assessment Rubric

  • Minimum pass
  • Claims map to explicit evidence.
  • Legends contain enough detail for interpretation.
  • Reviewer responses are specific and technically grounded.
  • Strong performance
  • Clearly separates robust findings from tentative interpretations.
  • Uses limitation language without weakening valid conclusions.
  • Improves reproducibility via concrete method-detail additions.
  • Common failure modes
  • Narrative claims that cannot be traced to figures.
  • Missing dataset/method versioning in captions.
  • Reviewer replies that are persuasive but non-technical.

Exit Ticket

Write one results paragraph from a connectomics figure and include:

  1. one quantitative claim,
  2. one explicit caveat,
  3. one sentence on reproducibility assumptions.

References (Instructor)

  • Gopen and Swan (1990) - The science of scientific writing.
  • White et al. (1986) - foundational connectome reporting style.
  • Januszewski et al. (2018) - modern method reporting and performance framing.

Teaching Materials

  • Module page: /modules/module17/
  • Slide page: /modules/slides/module17/
  • Worksheet: /assets/worksheets/module17/module17-activity.md