As I touched on above, if there's a type that we don't expect people to have to implement, that's another reason for us not adding comments. Obviously we're limited by the lack of a protected-scope in interfaces, so that means that we could end up exposing some methods and types which we would prefer to keep hidden. If there are particular examples, keep letting us know and we can clarify or fix on a case-by-case basis.