tweak the trait docs accordingly
some interlinking