more idl docs cleanup
Merge pull request #55 from dart-gde/comments2

more idl docs cleanup