[#255] Legacy API docs tweaks

Just tweak a couple of section headings and the introductory text