More basic XML Doco for publicly visible API

because eventually, [CS1591](http://msdn.microsoft.com/en-us/library/zk18c1w9.aspx) should be enabled again.