Code Conventions

[Lars Francke]

Great, I'll try to keep my eyes open.

On Fri, Feb 7, 2020 at 5:09 PM Jesper Wilhelmsson <
jesper.wilhelmsson at oracle.com> wrote:

> Once the project is proposed at announce at openjdk.java.net there will be a
> vote and from there the discussion will be in the public mailing lists.
> Provided the project is accepted a mailing list for it will be created and
> then the work begins :-)
>
> A big leap forward in this work was taken earlier this week and I'm
> currently waiting for the dust to settle after JFocus before having
> internal discussions with the current owners of the guide.
> /Jesper
>
>
> On 7 Feb 2020, at 16:55, Lars Francke <lars.francke at gmail.com> wrote:
>
> Excellent! That'd be great.
> I'd be happy to follow along and contribute if needed/possible. What would
> be the best place for me to follow your project (or the road to your
> project)?
>
> On Fri, Feb 7, 2020 at 4:53 PM Jesper Wilhelmsson <
> jesper.wilhelmsson at oracle.com> wrote:
>
>> I have recently started to dig into The OpenJDK Developer's Guide. My
>> goal is to have an OpenJDK project for the guide and start to add the
>> missing information there. There is a section for code conventions in the
>> guide. I think that once we have the project in place, that is the place to
>> have a discussion around code conventions and finally have an updated
>> version published in the guide.
>>
>> /Jesper
>>
>> > On 7 Feb 2020, at 10:31, Lars Francke <lars.francke at gmail.com> wrote:
>> >
>> > This is an old thread but it's still relevant.
>> >
>> > Is there any chance we can get Andreas' version published? It's been a
>> > DRAFT for years, there have been multiple discussions and I think he
>> > distilled most of them down into his current document.
>> >
>> > We can obviously keep discussing but there will always be differing
>> > opinions and we'll never update the old conventions.
>> >
>> > On Thu, Apr 11, 2019 at 3:47 PM Andreas Lundblad <
>> andreas.lundblad at gmail.com>
>> > wrote:
>> >
>> >> That page has said "This section will contain a major revision of our
>> >> antiquated code conventions" like forever. We came far with that major
>> >> revision a couple of years ago. Latest draft available here:
>> >>
>> >> http://cr.openjdk.java.net/~alundblad/styleguide/index-v6.html
>> >>
>> >> I even have a version adapted to openjdk.java.net formatting.
>> >>
>> >> I suggest we take this over the finish line and get it published
>> properly.
>> >> I
>> >> happen to have time to spare the coming weeks and am happy to
>> contribute.
>> >>
>> >> -- Andreas
>> >>
>> >> On Thu, Apr 11, 2019 at 5:47 AM Dalibor Topic <
>> dalibor.topic at oracle.com>
>> >> wrote:
>> >>
>> >>> On 22.03.2019 17:13, Jean-Claude Arbaut wrote:
>> >>>> https://www.oracle.com/technetwork/java/codeconvtoc-136057.html
>> >>>
>> >>> Merci Jean-Claude,
>> >>>
>> >>> I updated the link accordingly.
>> >>>
>> >>> cheers,
>> >>> dalibor topic
>> >>>
>> >>>> Le jeu. 21 mars 2019 à 11:33, Florian Weimer <fw at deneb.enyo.de> a
>> >> écrit
>> >>> :
>> >>>>
>> >>>>> This page
>> >>>>>
>> >>>>>   <http://openjdk.java.net/guide/codeConventions.html>
>> >>>>>
>> >>>>> contains only a dead link to:
>> >>>>>
>> >>>>>   <http://java.sun.com/docs/codeconv/index.html>
>> >>>>>
>> >>>>> Is this page archived somewhere?
>> >>>>>
>> >>>>> Right now, I'm particularly interested in formatting guidelines for
>> >>>>> exception messages.  Should they begin with a capitable letter?  Are
>> >>>>> there rules for producing certain clipped sentences?  (Such a rule
>> >>>>> appears to exist for the first sentence in a method documentation.)
>> >>>>>
>> >>>
>> >>> --
>> >>> Oracle <http://www.oracle.com>
>> >>> Dalibor Topic | Principal Product Manager
>> >>> Phone: +494089091214 <tel:+494089091214 <+494089091214>> | Mobile:
>> +491737185961
>> >>> <tel:+491737185961 <+491737185961>>
>> >>>
>> >>> ORACLE Deutschland B.V. & Co. KG | Kühnehöfe 5 | D-22761 Hamburg
>> >>>
>> >>> ORACLE Deutschland B.V. & Co. KG
>> >>> Hauptverwaltung: Riesstr. 25, D-80992 München
>> >>> Registergericht: Amtsgericht München, HRA 95603
>> >>>
>> >>> Komplementärin: ORACLE Deutschland Verwaltung B.V.
>> >>> Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
>> >>> Handelsregister der Handelskammer Midden-Nederland, Nr. 30143697
>> >>> Geschäftsführer: Alexander van der Ven, Jan Schultheiss, Val Maher
>> >>>
>> >>> Green Oracle <http://www.oracle.com/commitment> Oracle is committed
>> to
>> >>> developing practices and products that help protect the environment
>> >>>
>> >>
>>
>>
>