Update notes for submitted changes

* improve examples in heat api-ref