[schema] React to yams improvement of metadata attribute handling. * Change the way RichString is deprecated. * Add documentation about metadata attribute

<div id="ajaxroot">
  <div class="ajaxHtmlHead">
    <script src="http://foo.js" type="text/javascript"> </script>
  </div>
  <h1>Hello</h1>
</div>