> 4. Update the docstring, using the format suggested in > > http://projects.scipy.org/scipy/numpy/wiki/CodingStyleGuidelines
I realize this is a bit of a johnny-come-lately comment, but I was surprised to see that the list of sections does not seem to include the single most common reason I usually try to access a doc string ... the function signature. IMO, this item would ideally be the last item in a docstring so that one could quickly figure out which parameter belongs in which position, which are keywords, and what the defaults are without scrolling up multiple pages or having to mentally assemble this from a vertical list of parameters and optional parameters. Was this omission deliberate or an oversight? And more importantly, what do people think of adding it to the guidelines? Gary _______________________________________________ Numpy-discussion mailing list Numpy-discussion@scipy.org http://projects.scipy.org/mailman/listinfo/numpy-discussion
