adding documentation on types