aptana/studio3 — comment on commit 5d79dad8ac665b8dd584abb9e8eb537eef7a21c3
File: plugins/com.aptana.buildpath.core/schema/buildParticipants.exsd line 9
By thelonious:

I think it's a good idea to document the schema since this is equivalent in nature to an interface. I've haven't been good about this either.

I'm adding a comment here only, but it's generally useful to comment the extension point, it's elements, and the element attributes. There's a "Preview Reference Document" on the overview page that's helpful for this. I know I've caught places I missed since commenting via the UI is so fragmented.