Полное объяснение
Что должен знать каждый компьютерщик об арифметике с плавающей точкой
blockquote>https://docs.oracle.com/cd /E19957-01/806-3568/ncg_goldberg.html
Я знаю следующие инструменты, которые генерируют документацию от файлов схемы XML (XSD):
Для маленького XML-схема я, вероятно, предложил бы использовать таблицу стилей xs3p XSLT. Для больше сложной схемы я предлагаю использовать xsddoc.
Самая близкая вещь к Javadoc для XML-схемы, которую я видел, выполняет инструмент Javadoc на источнике, сгенерированном из схемы. Это требует двух вещей: 1) То, что Ваша схема имеет внутренние элементы аннотации, документирующие его, и что 2) Ваш исходный генератор использует те аннотации в качестве элементов Javadoc.
Я рекомендую использовать XSD для чего-то. А именно, покажите некоторые реальные приложения с примерами как реальный код.
Реальные приложения - то, что делает схему интересной. Примеры не должны быть большими, сложными или абсолютно реалистичными. Они просто должны скомпилировать. Другие люди захотят скопировать и вставить примеры кода.
Эти примеры "привет мир" схемы. И они действуют как своего рода модульный тест на схему.