[SciPy-dev] Namespaces in documentation

Bruce Southey bsouthey at gmail.com
Tue Jun 3 13:48:44 EDT 2008


Matthew Brett wrote:
>>>> Anyway, +1 for np/sp in docstrings
>>>>         
>
> Isn't there quite a strong majority view in favor of np, sp, among
> those working most on the code?
>
> Best,
>
> Matthew
> _______________________________________________
> Scipy-dev mailing list
> Scipy-dev at scipy.org
> http://projects.scipy.org/mailman/listinfo/scipy-dev
>
>   
That is largely irrelevant because documentation is orientated to people 
not working on the code as those that work on the code already know the 
code. An important aspect of documentation is to reach out to people who 
are don't have the depth of the knowledge so they can use NumPy in any 
way that they want to (in accordance to the licensing).

Bruce



More information about the SciPy-Dev mailing list