arbor-sim
Document return types for recipe method implementations
The API docs on recipe's at https://docs.arbor-sim.org/en/latest/python/recipe.html#arbor.recipe.cell_description list all the functions one should implement and describe in prose what each function is supposed to do. For most functions this is adequate information to piece things together, but could the rtype be added to each function? That would provide a direct link to each return type
Additionally, a link to a tutorial or code example implementing all these functions could be added in the head section https://docs.arbor-sim.org/en/latest/python/recipe.html#recipes
@noraabiakar I guess the recipe.global_properties() issue I mentioned falls under this category of missing return type links. It also says kind in the argument list.
Piling on here on the recipe methods: the docstring for probes(gid) is kind of dense and unclear, another good location for an example.