I took my chances on this mutated huge topic, and put in some time to see what I can do. This topic is one of the worstest, even making it to the Reducing the number of examples... question by @Squidward, and it is wrong on several other counts too.
My draft I put some effort into, but is not anywhere complete
I have to emphasize: I don't like this draft. Actually, the more time I put into it, the more I hate it. I wanted it to be an elegant silver bullet to the situation, but it fails at that miserably.
It is probably better than the current status of the topic, but it is not yet anything I could imagine anyone would use efficiently. There are some parts that I both like and hate in it, that is why I put this up here.
What I hate about it:
- lot of textbook content there (need larger cleanup than I am proficient with)
- some parts should be in other topics - e.g. Stream related stuff should be a probably fit in the Streams topic (but that's two times full already...)
- Fluff moved to "Remarks" - completely useless this way
- "Cheatsheet" example on top - not a good single-responsibility example
- Similar examples merged like "Adding and removing elements" - lost valid single examples
What I (at least marginally) like about it:
- Fluff moved to "Remarks" - not cluttering examples
- "Cheatsheet" example on top - I think this would be the most useful part of it (--> though not a good single-responsibility example)
- Similar examples merged like "Adding and removing elements" - showing together what deals with similar aspects
During the time I put into this trying to get it somewhere, I got tired and I think I don't see the light at the end of a tunnel anymore...
Take it apart, and please suggest!
- Is the direction generally OK or completely wrong?
- Can you spot clearly good/bad individual parts of my edit in contrast of the current status?
- Is it acceptable to reduce the amount of examples by merging them when they are of similar aspect (Adding elements, Removing elements -> Adding and removing elements)?