[Python-Dev] cpython (merge 3.3 -> default): Merge with 3.3 (original) (raw)

MRAB python at mrabarnett.plus.com
Wed May 29 01:42:18 CEST 2013


On 29/05/2013 00:29, Terry Jan Reedy wrote:

On 5/28/2013 3:39 PM, Antoine Pitrou wrote:

On Tue, 28 May 2013 15:06:39 -0400 Terry Reedy <tjreedy at udel.edu> wrote:

Yes, Nick suggested README instead of what I had. I want a prefix to keep it near the top of a directory listing even when other non 'testxxx' files are added. I thing '' wold be better though. I don't think "prefixing with a weird character '' is not weird for Python names. so that the filename show up top" is a very elegant trick, I disagree. Books have Table of Contents, Preface, and Foreword sections at the front for a reason: if they are present, they are easy and obvious to find. READMEs are like a preface*, sometimes with an annotated Contents. They logically belong at the top for the same reason. A long title for this how-to file, which I would prefer, would be something like "Writing-Testing-RunningIdleTests", or "IdleTest-WritingGuidelines", or "AGuidetoIdleTests", or "AnIdleTestHOWTO". [snip] I'm somehow not happy about "_README", what with a single underscore indicating "internal" in Python code.

Perhaps it would be a bit more Pythonic to have "README" instead (dunder would be overdoing it, perhaps). :-)



More information about the Python-Dev mailing list