Code Conventions
Lars Francke
lars.francke at gmail.com
Fri Feb 7 15:55:32 UTC 2020
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> | Mobile: +491737185961
> >>> <tel:+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
> >>>
> >>
>
>
More information about the discuss
mailing list