Tutorial alpha user feedback: Getting Started

[sbrincat]

General I wonder if somewhere on this page we could give like a brief overview of the organization of the whole Neuroblox ecosystem? Over the course of the tutorials, I bootstrapped an understanding that NB includes low-level functions to simulate single neurons and higher-level functions to simulate entire circuits and brain regions, as well as a host of utility functions for extracting and plotting measurements from those simulations. But I think it would be a lot easier for users if we just explicitly explain that organization (or however we want to conceptualize it) at the start, to set that up as a schema for all the tutorials to follow.

Cell 1

• The description below this cell doesn’t match the code – there is no adj[i,j] matrix
• In the add_edge!() calls here, unlike almost all the other tutorials, have arguments separated by semicolons, rather than commas. Can we align the style with the other tutorials?

Cell 4

• Would be helpful to insert a comment briefly explaining what state_timeseries() is doing, and maybe something in the text above the cell introducing this category of NB functions (presumably these are like the “measurement” functions?).

[harisorgn]

I wonder if somewhere on this page we could give like a brief overview of the organization of the whole Neuroblox ecosystem?

Agree that this would be very useful. Maybe a visualisation of a graph/Venn diagram with Neuroblox components.

I will be addressing the rest of the points in a PR soon.