Further modernize lint documentation
Summary: Ref T2039. Contains a small amount of wishful thinking, I'll note it inline.
Test Plan: Generated and read documentation.
Reviewers: btrahan, avive, joshuaspence
Reviewed By: joshuaspence
Subscribers: epriestley, avivey
Maniphest Tasks: T2039
Differential Revision: https://secure.phabricator.com/D9061