[SciPy-dev] Namespaces in documentation

[Bruce Southey]

Jarrod Millman wrote:
> On Mon, Jun 2, 2008 at 1:47 AM, Johann Cohen-Tanugi
> <cohen at slac.stanford.edu> wrote:
>   
>> Anyway, +1 for np/sp in docstrings.
>>     
>
> +1
>
>   
-1
It is inappropriate for beginners, see for example the official Python 
tutorial (http://docs.python.org/tut/) and documentation. Both of these 
make heavy use of 'import module' syntax except to extract submodules.

Bruce