add documentation for the new metadatas update method