Reinstate lost doc comments

[gewarren]

Comment loss. Looks like we'll have to manually port the doc comments for the renamed interfaces.

Originally posted by @gewarren in #8122 (comment)

cc @carlossanlop

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.