Make example_generated agree with the big example in the crate docs

[brson]

There are two big examples in this crate - the one in the crate-level docs, and the one in the example_generated module; and they are not the same. Make them the same: start from the one in the crate docs, and add any missing useful information from the existing example_generated module.