jsonschema2pojo creates empty <p> tags, if there is a title schema annotation but no further schema annotations.
TitleRule adds a <p> tag to the Javadoc always. If there is no further schema annotation, e.g. typically a description, the paragraph is empty. This causes a Javadoc Warning.
Maybe it would be better to add the <p> tag in the DescriptionRule though I fear this is inadequate and it must be added for other annotations/keywords/extension too (e.g. javaName, $comment, etc.).
Probably it might be better to write <p> tags only if really needed, e.g. if there is a title and a description, but it seems that this must be implemented in other classes, like PropertyRule (and others).
Even if it is good style to add both, a title and a description to the JSON Schema, it is also correct to have only one of both (or none of them).
jsonschema2pojo creates empty
<p>tags, if there is atitleschema annotation but no further schema annotations.TitleRule adds a
<p>tag to the Javadoc always. If there is no further schema annotation, e.g. typically adescription, the paragraph is empty. This causes a Javadoc Warning.Maybe it would be better to add the
<p>tag in the DescriptionRule though I fear this is inadequate and it must be added for other annotations/keywords/extension too (e.g.javaName,$comment, etc.). Probably it might be better to write<p>tags only if really needed, e.g. if there is atitleand adescription, but it seems that this must be implemented in other classes, like PropertyRule (and others).Even if it is good style to add both, a
titleand adescriptionto the JSON Schema, it is also correct to have only one of both (or none of them).