Update IndexedPiece.metadata() API Docs

As inspired by Saining, there should be a note about how not all fields
are always available, why, and which ones are.