docs: improve our XML documentation
In a lot of places we don't list specific attributes and elements combinations that are valid. Sometimes it's hidden in the blocks of texts and in general it's difficult to figure it out.
Even though this is very generic task that would require a lot of modifications we can keep it open and apply for Google Season of Docs.