@thednx
When I said it looked like you were going to write a full blown handbook that was no critique, just an observation. What I could imagine alongside a certain feature, is a reference to a little side tutorial.
For example, a handbook would explain what an Exit Portal is and that the volume must be fully enclosed and that the surface normal must point into the room etc.
Problems then arise because a user attempts to generate a simple scene. Sun shining into a room, through a glass window with Pathtracing chosen as the render method. That combination of Exit Portal and render mode only renders indirect lighting so the sun patch on the floor is missing. That is not explained anywhere. The poor soul also forgot to enable "glass acceleration" and the walls were full white
I would imagine a short tutorial explaining features in the context of a not too simple scene. This is probably bordering on heresy but I could do with something more ... ummmm... applicable than a Utah teapot or Suzanne.
There are other little scenes that new users often grind their teeth on. Caustics in a pol of water for example, or the first wine glass that unfortunately has a size similar to the Blender default cube thus the wine renders nicely black and what the heck was precedence for ?
This stuff is almost exclusively found by sifting through years of forum posts and there is a host of valuable little tricks that would be very nice to see written somewhere. I'll start digging for applicable forum threads and posts.
Also, you asked, nicer renders would be...well... nice. My quad core iMac mostly does nothing so I'd gladly render nicer images for the tutorial.