more comments, YUI docs, and style changes