Update notes for submitted changes

* add hints to api_samples documentation