Re: readability of sample programs in tutorial
Julien Palard via Doc-SIG <[email protected]> Sun, 13 May 2018 05:02:34 -0400
| Newsgroups | gmane.comp.python.documentation |
|---|---|
| Message-ID | <rclztKzrncByN27-Jq0RHWjN2nW0o-NFkc2pPjYXYPUfk-1-iXp1Pq253XLd3eQjDLCcw5e7b-N4kYcgAu9gP9eT-ov1mopxIID7f5hiyus=@palard.fr> |
Hi, On 12 May 2018 10:11 PM, Xuan Wu <[email protected]> wrote: > The program's meaning becomes obvious only after all this history study. Yes, but don't forgot that this is not a program (demonstrating usefull behavior), but a sample, demonstrating syntax. > It was fun for sure, but IMO most readers won't go that far, as I didn't find any of such explanations online so far. Which is fine, as the example is OK to understand syntax. Understanding what authors had in mind back then while redacting examples is a whole other level of reading. PS: Good lunk understanding what the author of >>> words ['defenestrate', 'cat', 'window', 'defenestrate'] had in mind (yet it does not hurt readability of the example, IMHO). -- Julien Palard https://mdk.fr _______________________________________________ Doc-SIG maillist - [email protected] https://mail.python.org/mailman/listinfo/doc-sig