update Director JEP proposal (added notes/comments to the proposed API examples)