RFR: 8333230: Improve code example in doclet package [v2]

[Nizar Benalla]

On Mon, 19 Aug 2024 16:35:29 GMT, Nizar Benalla <nbenalla at openjdk.org> wrote:

>> Can I please get a review for this simple change? It's an attempt to improve the code example in doclet package.
>> Here are the generated docs with the [new code example.](https://cr.openjdk.org/~nbenalla/GeneratedDocs/newDocletExample/api/jdk.javadoc/jdk/javadoc/doclet/package-summary.html#Example.java)
>> 
>> I tried to go for simplicity while showing some features of the standard doclet, running this Doclet on a small project gives the following ouput.
>> 
>> 
>> Note: org.example.Example -> src/main/java/org/example/Example.java CLASS
>> Note: org.example.SimpleDoclet -> src/main/java/org/example/SimpleDoclet.java CLASS
>> 
>> 
>> 
>> TIA
>
> Nizar Benalla has updated the pull request incrementally with one additional commit since the last revision:
> 
>   rename SimpleDoclet to Example so that TestDocletExample.java passes

Closing this for now until we decide how to go about this, it may be better to have a `Hello World` example than have the code run on itself

-------------

PR Comment: https://git.openjdk.org/jdk/pull/20619#issuecomment-2402337817