FWIW, it makes sense to me that "value based" semantics should be applied
as an annotation. The documentation fits that better than a side-note.
Ex:
@ValueBased
public class Optional { ... }
And consumers of the annotation are easier to find.
--
Cheers,
Paul