update docs on metadata object