Usage examples

[ash211]

How should these annotations be used? Do they work only for JAX-RS endpoints, or are these also the annotations that should be placed for log4j calls?

Please provide usage examples in the README for how to use this library.

[TheBeruriahIncident]

Related, there's rumor that usage example given is not the normal way to use this. It shows:

Preconditions.checkArgument(uname.size() > MAX_LEN, "{} username longer than max {}", 
        UnsafeArg.of("uname", uname), SafeArg.of("max", MAX_LEN));

but I hear that:

Preconditions.checkArgument(uname.size() > MAX_LEN, "Username longer than max length", 
        UnsafeArg.of("username", uname), SafeArg.of("max length", MAX_LEN));

is more normal. I.e. the message stands alone and doesn't use args.

Is that true? If so, we can probably tweak the example.