Fix typos in recent lint documentation. Fixes typos and markup errors, and also makes the examples more realistic by hiding the `;`s so as not to visibly be discarding the computed value. Affected lints: * `redundant_as_str` * `unnecessary_map_on_constructor` changelog: none