add docs to classes and defines to make lint happy