[Python-ideas] doc anomalies

[Rustom Mody]

On Mon, Apr 13, 2015 at 2:55 PM, Tal Einat <taleinat at gmail.com> wrote:
>
> Hi Rustom,
>
> On Mon, Apr 13, 2015 at 8:21 AM, Rustom Mody <rustompmody at gmail.com> wrote:
> > Hi all
> >
> > As a teacher who often ends up teaching python, sometimes I/my students
> > encounter little anomalies
> >
> > [Bugs?? I hesitate to use the word given how often Ive seen a noob exclaim:
> > "Compiler has a BUG" without knowing abc of the syntax
> > ]
> >
> > So just a question (or 2):
> > 1.
> > In python3 please check
> > help()
> > followed by
> > PACKAGES
> > and
> > DYNAMICFEATURES
> >
> > Do those help texts look helpful/meaningful?
>
> Please specify the precise version of Python you are referencing (e.g. 3.4.2).
>

Yeah 3.4.2
2.7.8 seems much the same


>
> I would be helpful if you didn't just throw out these questions, but
> also suggested improvements.
>

As for DYNAMICFEATURES the text makes no sense (to me)... so dont know
what to suggest
As for PACKAGES I guess one could come up with a much cut-down and
pointed version... if that's the intent

> > 2.
> > Is this the right list for such questions?
>
> This list is for ideas for the improvement of Python. Discussing
> significant changes to documentation and help resources can be
> relevant here, depending on their nature and breadth.

Well in fact a bunch of my students and myself will be working on
various sides of python internals.
Dunno how much will finally be suitable for actual patches and how
much just mucking around :-)
So was wondering about the best sources of help/guidance with python internals