Content deleted Content added
Linking to sources for this article |
|||
Line 278:
:Would that work? We could of course try to invent a broader-scoped definition, but I'm hesitant to do so. -- [[User:Dmeranda|Dmeranda]] 21:39, 24 April 2007 (UTC)
===Fuzzy or Hairy?===
The definition at the very start of the article is very hard to parse. It overuses analogy and is quite confusing. Perhaps later in the intro section it might be comprehensible, but at 0300 in the morning w/ a non-working GRUB2 EFI configuration hanging over my head, I just ditched trying to read the article and leave this short note waiting for the rest of my update to download.
'''Please start the article with a definition.''' E.g. ''"In a programming language, a generator is..."''. Try to stay at a very non-computer science language level with the definition or include the WP article link for every bit of jargon you need to be clear. So you start by saying that a generator is a type of [[Iterator]]... What you should not say is that it is like an array, since it isn't anything like an array. You might use a generator to access values in an array. You can use a bucket to empty a bathtub full of soapy water, but don't confuse the bucket with the bathwater (and for heaven's sake, take the baby out first!).
Sorry, but most of my programming experience is with Java (w/o generators as a built in, but I am sure I have had to write thousands of them w/o ever knowing what the hell I was doing), or I would try my hand at a new intro.
== Needs verification ==
| |||