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