adding documentation regarding examples