[SciPy-dev] Namespaces in documentation

Bruce Southey bsouthey@gmail....
Tue Jun 3 12:48:44 CDT 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@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