brainhack / notesOPEN NEUROSCIENCE
SWITZERLAND
← Field notes
Collaboration

Make your project easy to join.

A useful project brief gives a newcomer a first contribution, not just an ambitious title.

Give the invitation a shape

‘Help us explore brain data’ is an invitation, but it is not yet a task. A person arriving at a collaborative session needs to know what the group is trying to learn, what exists already and where an extra pair of hands would help. State the project in a paragraph before describing the technology.

Make the first contribution small and inspectable. It could be checking a figure label, reproducing a notebook cell, explaining an unfamiliar term or comparing two documented outputs. Coding can be part of the work without being the only way to participate. Do not promise that every task is suitable for every background.

Use a one-page brief

Begin with a question and the reason it matters for this exercise. Then name the input, the intended output and the boundaries of the work. Add a short ‘not doing today’ list. This keeps an exploratory session from becoming a vague commitment to solve the entire research problem.

List practical requirements honestly. If a task needs a large download, institutional access or specialist knowledge, say so before someone commits their afternoon. Offer a contribution that does not depend on that access where possible. A documentation review or synthetic example can let someone help without receiving restricted files.

Make decisions visible during the session

Choose a place for notes that participants can actually use. Record decisions as they happen: a parameter was changed, an input was excluded or a result was set aside. Include the reason, not only the action. At the end of a busy day, memory rarely provides a reliable substitute for a short written record.

Agree who can accept a change and how contributors should ask for help. A newcomer should not have to interrupt every conversation to discover the next step. Brief check-ins can reveal when somebody is waiting on a missing file or an unexplained assumption rather than making progress.

End with a handover, not just a demo

Reserve time to explain the result and its limits. Show what was completed, what failed and what remains a question. A clear negative finding or a reproducible bug can be a worthwhile outcome of a short project. Avoid dressing an exploratory exercise up as a validated conclusion.

Leave the next person a starting point: the latest working instructions, the unfinished task and the name of the decision that still needs to be made. Credit contributions accurately, including writing, review and coordination. A collaborative session has lasting value when the work remains understandable after the participants have closed their laptops.