Andreas Röhler <andreas.roeh...@online.de> writes:

> Oh, oh, so what kind of punishment you have prepared? :)

Me preparing punishment?  Not my kind :-).  My poor knowledge of English
makes me miss the meaning of the above sentence, but as it is ended with
a smiley, I presume it is a friendly tease!

> outline and hide-show mode are common Emacs features and will work
> with python-mode out-of-the-box.

They will surely not, if users have to explicitly turn them on.  You
probably meant: these minor modes would work, if turned on.

> The question here is, if it should be switched on by default.  Read
> "notice" here as "being activated, thus get noticed" Well, for
> novices, if these features are on, using some key per chance without
> knowing what happens, that may turn nasty.  Therefor it's not
> delivered switched-on by default, that has being the reflection.

OK.  If this is really the reason, it is a good reason.  As I wrote in
some earlier message, python-mode has not only the right to, but the
duty of an "opinion" about what is best for average Python users, and
should deliver itself defaulted according to this opinion.

>> Did you update README?  That file should speak about capabilities and
>> elementary configuration.

> Agreed. Will do what I can, Sunday, Monday, Tuesday, Wednesday,
> Donnerstag... - the day of donar :)

The importance of giving some usable documentation for python-mode
should not be underestimated.  I see it as a top priority in the case
here, because it is severely lagging.  And when I say "lagging", this is
a polite euphemism, "lacking" would me a more appropriate description.

That importance goes above that of all the Blueprints altogether, you
know :-).  Oh, no doubt it is a good thing to have self-aimed internal
documentation meant for planning, but if we take even a moderate
distance with the python-mode project and look at its current state, the
priority is clearly user documentation, not maintainer documentation.

README and INSTALL are very sub-minimal currently.  Only once
python-mode has a least minimal documentation, resume in parallel user
and maintainer documentation, and try to never lose sight again of the
users in the process.  Make it a principle: "Users first!" :-)

François

_______________________________________________
Python-mode mailing list
Python-mode@python.org
http://mail.python.org/mailman/listinfo/python-mode

Reply via email to