AllenInstitute / AllenInstitute/Teaching_Connectomics

First synapse example is confusing

Open
#11 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
1
Forks
2
PR merge metrics
No merged PRs in 30d

Description

Already spoke with a few of you about this but wanted to document it here. the first example synapse in module 2 is confusing because it appears to be dendro-dendritic: https://spelunker.cave-explorer.org/#!middleauth+https://global.daf-apis.com/nglstate/api/v1/6470333031776256

this is a real bouton pre-synaptic, but @lelabbady and I are suspicious that it is falsely merged onto the "presynaptic" dendrite, her proposed edit is here, i.e. this bouton is part of this piece of axon https://spelunker.cave-explorer.org/#!middleauth+https://global.daf-apis.com/nglstate/api/v1/4917139680002048

regardless, is a confusing example for people to see for the first time. the images in the notebook should be updated also

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Locate the Module 2 notebook and its first synapse example, then review the linked viewer states and proposed edit. Update the example and its notebook images so the real presynaptic bouton is not presented as dendro-dendritic, and verify the rendered material is clear.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.