DOC : modified docs is HasTraits.traits and HasTraits.class_traits

change list -> dict to reflect what the code does and clarified how
kwargs work (instead of just referencing enthought.traits).

A few minor pep8