Docs: fix some of the markdown for Android Lint

* Fixes broken links
* Clarify that the `issues` field lives inside a Kotlin file to help the
  reader find it
* Instructions to run lint locally

Bug: None
Test: None
Flag: DOCS_ONLY
Change-Id: If6918e5fefb359df8613b843056a7c9faa6a5f1f