Firstly this may or may not need documentation. In 1.2 there is now a checkbox in the rendered panel to include remarks when rendering. When this option is checked the remarks will be included in the live rendering and will show up highlighted in purple. I suspect this might be best added to topic 21231. See BZ#1019028 for additional details.
Verified that the docs have the requested information thanks Jared. As for the colours, I'm gonna hand that over to Matt as he did the implementation. I'd have to agree with you though that the colour should be the soft yellow used in the brand.
The needinfo request[s] on this closed bug have been removed as they have been unresolved for 1000 days