am 0a96a82b: am 0cb2c76b: Merge "Doc update: clarify best practices." into klp-docs

* commit '0a96a82bbe153ed2337b67435016d35eb434da16':
  Doc update: clarify best practices.