On Sun, Apr 27, 2014 at 6:34 PM, Steven D'Aprano <st...@pearwood.info>wrote:
> > I would agree with having at least one example done with one arg per > line. > > Is it really necessary? I think that one-arg-per-line is an obvious > variation of the existing example. > not really -- a lot of folks learn more from following examples. If all teh examples are the same in some aspect, we'll tend to think that that's intentional, and that is at least the recommended method.... > If the only example given was one-arg-per-line, then the reader might > wrongly assume that *only* one arg was allowed. indeed -- but maybe less clear but the the fact that none of the examples show one argument per line, the implication is that that is discouraged. very had to document a widely variable standard! -Chris -- Christopher Barker, Ph.D. Oceanographer Emergency Response Division NOAA/NOS/OR&R (206) 526-6959 voice 7600 Sand Point Way NE (206) 526-6329 fax Seattle, WA 98115 (206) 526-6317 main reception chris.bar...@noaa.gov
_______________________________________________ Python-Dev mailing list Python-Dev@python.org https://mail.python.org/mailman/listinfo/python-dev Unsubscribe: https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
