add description and notes in definitions file