[doc] Cleanup documentation

Also add a convention on commit message length