docs(directives): Edit for dartstyle and clarity.

Closes #1037