Merge "Doc update: clarify rules for rate param" into jb-mr1.1-docs