improving docs about converters


* adding `@Convert` when using `@Specializes`
* adding `@Alternative` example and explanation