search

highsource / jaxb2-basics

Useful plugins and tools for JAXB2.
BSD 2-Clause "Simplified" License
109 stars 54 forks source link

Potential Documentation Improvements #2

Closed jheyd closed 10 years ago

jheyd commented 10 years ago

At http://confluence.highsource.org/display/J2B/Simplify+Plugin the annotation is at one point placed in the choice, not in an element, which might lead to some confusion.

At the same page, in the section "Usage" there is an xsd snippet containting the part jaxb:extensionBindingPrefixes="... simplify" I think it would be a good idea to replace this with xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" jaxb:extensionBindingPrefixes="<otherPrefixes> simplify" and to explain somewhere that in order to use this plugin the -extension option needs to be set.

Experienced users should know the xmlns:jaxb... part but it can confuse users who dont know that much about xml and jaxb.

highsource commented 10 years ago

I hope this is now fixed here: https://github.com/highsource/jaxb2-basics/wiki/JAXB2-Simplify-Plugin

If not, I'd be gratefult for a PR with the correction.