[SciPy-dev] Documenting data attributes
Thu Jun 25 16:10:47 CDT 2009
Well, they're already being documented separately (see, e.g., http://docs.scipy.org/numpy/Milestones/#ndarray-ii-status-63-done-leader-your-name-here, under which several data attributes are listed as needing documentation, independent of the separate listing of numpy.ndarray under http://docs.scipy.org/numpy/Milestones/#ndarray-ii-status-63-done-leader-your-name-here).
--- On Thu, 6/25/09, Robert Kern <email@example.com> wrote:
> From: Robert Kern <firstname.lastname@example.org>
> Subject: Re: [SciPy-dev] Documenting data attributes
> To: "SciPy Developers List" <email@example.com>
> Date: Thursday, June 25, 2009, 1:55 PM
> On Thu, Jun 25, 2009 at 15:49, David
> > Hi! For the purposes of meeting the documentation
> standard, are data attributes regarded has "returning"
> something, i.e., should ndarray.itemsize, for example, have
> a Returns section?
> I would describe them in an Attributes section of the
> docstring. See MachAr for an example I did some time ago.
> Robert Kern
> "I have come to believe that the whole world is an enigma,
> a harmless
> enigma that is made terrible by our own mad attempt to
> interpret it as
> though it had an underlying truth."
> -- Umberto Eco
> Scipy-dev mailing list
More information about the Scipy-dev