lbruun commented on issue #1: Updated Java Doc with better description and examples of presenters, ? URL: https://github.com/apache/incubator-netbeans-html4j/pull/1#issuecomment-342414646 Definitely not wrong. I guess it is a matter of religion. I tend to agree with [Stephen Colebourne](http://blog.joda.org/2012/11/javadoc-coding-standards.html) : > **Use simple HTML tags, not valid XHTML** > > Javadoc uses HTML tags to identify paragraphs and other elements. Many developers get drawn to > the thought that XHTML is necessarily best, ensuring that all tags open and close correctly. This is a > mistake. XHTML adds many extra tags that make the Javadoc harder to read as source code. The > Javadoc parser will interpret the incomplete HTML tag soup just fine. and as far as I can tell the official advice from Oracle is (still) also to use a single `<p>`, even in JDK8 and JDK9. Personally, I would say just pick a style and stay with it and it this sense this PR was different from the rest of the html4j code base. Not important, just a comment. Looking forward to more html4j releases ! :-)
---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected] With regards, Apache Git Services
