am db164da8: Merge "improve some docs for dreams" into jb-mr1-dev

* commit 'db164da885d15723597d6a525d0f46cb55dbcb88':
  improve some docs for dreams