document and update style guide for decorations