It is possible to add tags and description etc. to an alternatives node. Unfortunately if you describe the whole set an alternatives node gets converted to a simple array without any of the tag or description information. (also it doesn't show up if you set the node to required) I am currently puzzled at how to generate documentation of a now which got deprecated.