Andreas Röhler <andreas.roeh...@online.de> writes: > Am 29.01.2012 04:24, schrieb François Pinard:
>> * README nor INSTALL should tell about PYMACS_INSTALL_DIR >> * The change addresses a need which Pymacs does not offer >> * python-mode should work with the minimum setup possible >> * python-mode should pay attention at keeping its copies up-to-date >> * Observed flaws should be duly reported upstream > think that's our understanding too. Should something in the past > didn't happen that way, assume rather a lack of force than a lack of > will. Yes, this is what I assume. (Same for user documentation.) Yet we have to speak out about such things, because laziness being what it is (I do know what laziness is!), those accidental misses progressively transform into habits, habits into rights, and rights into principles. We have to stay careful all along, and discuss methodology problems early -- as long, of course, as discussions do not suck up the left bits of energy! > Remains the question if a README is the suitable place for storing > that kind of info. In the current state of affairs with python-mode, yes, clearly, undoubtedly. > See you did it at Pymacs and certainly thats a possibility. Pymacs documentation is not in README, it is a reStructured Text formatted manual (the pre-processor has its own separate manual). But when Pymacs started and had nothing else, yes, it was all in README. README is the traditional unavoidable file in a distribution, where users seek for installation instructions and user documentation (or at least, pointers to where it sits, when not included). > Indeed we are severely behind writing the info. Sorry for that. > Exists a Milestone already, 6.1.1 should deliver it - maybe already > 6.1? Making Milestones, Blueprints, Gantt charts about it is not effective. Fill in the README details *right now*, when you happen to stumble on them. When you see yourself thinking "Hey, I'll add this information later into the Great Documentation I'm planning to have", slap yourself! :-) Rather *immediately* dump the information, all raw, all unformatted, into README. Do not even try to be proud of it, that would come later. For now, just pour information in it at any opportunity. > May you open your own branch forked from trunk at lp? Could merge > than all Pymacs diffs easily. Hey, let's move python-mode over to GitHub instead :-) And besides, if people really think it is hopeless to ever get python-mode integrated into Emacs, is there much remaining reason left, sticking with Bazaar? Keep happy! François P.S. Behind the above tease, I hope you see my point: maintainers should get away from this attitude of always attempting to pull all users (or other maintainers) in their own playground. This is one of the aspects I hate about trackers and other maintainer toys. While it's comfortable for me to get a mere "pull request" on GitHub, I'd never try to force my users into it, as it might not be comfortable for them. My comfort is not *more worth* than theirs. _______________________________________________ Python-mode mailing list Python-mode@python.org http://mail.python.org/mailman/listinfo/python-mode
