update documentation for IndexedPiece.metadata