docs for all class methods (most of them just say "Like Enumerable#, but chains operation to be lazy-evaluated.", but I believe they are useful this way because now have proper call-sequences and link to corresponding Enumerable's explanations)
simplified example for ::new to emphasize the main concept
Enumerable#lazy docs are slightly lightened and linked to this class for more in-depth explanations.
Add Enumerator::Lazy docs.
[Misc #15529][ruby-core:91046]
Co-authored-by: zverok zverok.offline@gmail.com
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@67320 b2dd03c8-39d4-4d8f-98ff-823fe69b080e