RFR: 8300792: Refactor examples in java.net.http to use @snippet [v4]

Daniel Fuchs dfuchs at openjdk.org
Thu Feb 23 16:19:49 UTC 2023


On Thu, 23 Feb 2023 15:24:23 GMT, Darragh Clarke <duke at openjdk.org> wrote:

>> Refactored instances of `@code` to instead use `@snippet`.
>> 
>> I also spent some time looking into using external snippets to reference the existing files `JavadocExamples` and `WebSocketExample` though ultimately thought it was better to keep the docs pretty much as they had been with only a few small changes to formatting.
>
> Darragh Clarke has updated the pull request incrementally with one additional commit since the last revision:
> 
>   missed one set of examples

LGTM. The API documentation with each example in its own snippet also looks better IMO.

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

Marked as reviewed by dfuchs (Reviewer).

PR: https://git.openjdk.org/jdk/pull/12692


More information about the net-dev mailing list