document various traits