RFR: Add start on a section about logging [v2]
Ludvig Janiuk
duke at openjdk.java.net
Mon Jan 17 13:39:39 UTC 2022
On Mon, 20 Dec 2021 22:56:10 GMT, David Holmes <dholmes at openjdk.org> wrote:
>> Ludvig Janiuk has updated the pull request incrementally with one additional commit since the last revision:
>>
>> cleanup
>
> I think the Developer's Guide should be focused on process. It is a guide to enable people to make contributions. It cannot be a technical development guide for all different areas of the JDK - that would be completely impractical and would lead to factoring out the real "getting started" process oriented guide.
>
> There is a place for a Hotspot Developer's Guide to replace the wiki materials, but that should be a completely separate document IMO.
>
> David
@dholmes-ora while the dev guide focuses largely on process, I don't think it was ever meant to exclusively cover that. In the first few paragraphs I read:
> The OpenJDK Community is a fairly pragmatic place. “Do the right thing” is most often the right course of action. Still, if people do things in the same right way then everyone’s work becomes more transparent and easier for others to follow. For this reason most parts of the development process have standard flows that are the recommended ways to do things.
> The goal of this guide is to answer questions that developers of the JDK might have around development process, tooling, standards, and so forth.
Logging is a question developers have. And we do have a "right way to do the thing": Unified Logging! So it seems well-aligned with the goals of the dev guide to answer that question and point people in the right direction.
-------------
PR: https://git.openjdk.java.net/guide/pull/70
More information about the guide-dev
mailing list