use a sane documentation standard

Change-Id: Ifaf433d106ccf950731e6b83fe36deefd4e2542a
Merge "use a sane documentation standard"