Add utility, @Documented annotations to announce what is coming

And use them. And my god is a whole lot of stuff still to be annotated!