add and document metadata helper method