Java outreach page might need updating

[dalibor topic]

On 12.11.2016 20:23, Mani Sarkar wrote:
> Hi Dalibor,
>
> This evening we had an online VJug session with LJC and IceJUG. One of
> the participants brought to my notice one piece of information on the
> outreach page at
> https://wiki.openjdk.java.net/display/Adoption/JDK+9+Outreach. I found a
> few more thereafter and thought I share it with you and the others.

Thanks, that's great!

> I'll list the issues as I remember them:
> - Info about fatal error mention on permgen, this one has changed - the
> severity has been lowered by a new change to JDK9 - thanks Patrick

Can you provide a link to the issue in JBS that corresponds to that 
change, please?

> - the link to email to the adoption discuss group does not directly lead
> to the page where users can sign up and then be able to send emails to
> the list.

Fixed, thanks!

> - some information about changes to access to unsafe or other apis that
> are going to be restricted for developers, was missing

It's there: 
https://wiki.openjdk.java.net/display/Adoption/JDK+9+Outreach#JDK9Outreach-EncapsulateMostInternalAPIs 


> - information on apis those deprecated in java 9 but will be removed in
> java 10, is also missing

Thanks - I added 
https://wiki.openjdk.java.net/display/Adoption/JDK+9+Outreach#JDK9Outreach-EnhancedDeprecation 
to cover that and point to the JEP text for more information.

> - performance info

That's rather out of scope of the document.

It's focused on changes targeted for JDK 9 which may affect code that 
relies on default, deprecated, removed, unsupported, internal or 
unspecified functionality. Performance characteristics of Java SE 
functionality and APIs are in most cases not specified, as far as I know.

> - backward compatibility info
>     - changes that may/will break compatibility

Yeah, that's what this document is mostly focused on.

>     - changes may/will have no impact on compatibility

There are other documents describing the general scope of changes in JDK 
9, such as the one linked off in 
https://wiki.openjdk.java.net/display/Adoption/JDK+9+Outreach#JDK9Outreach-JDK9Features 
.

Let's not duplicate them. ;)

>     - workaround suggestions to stay compatible with older versions of Java

Do you have specific examples that should be included, aside of 
https://wiki.openjdk.java.net/display/Adoption/JDK+9+Outreach#JDK9Outreach-Crosscompilationforolderplatformversions 
?

> It's highly likely you have the information mentioned above in some form
> or shape on the outreach page. But it would still help if they were
> marked explicitly with these titles/subtitles as there were many
> questions during our session, regarding these topics and we didn't have
> a canonical source to point them onto. So our answers were what we could
> pull out of our memories from past experiences.

OK - could you provide a mock up of what you think it should look like?

> I appreciate jdk9/jigsaw is a moving target and we are at the bleeding
> edge.
>
> Thanks for putting the content together, they have been helped and have
> good detail in it.
>
> I hope this helps.

It's great - thank you very much for using this resource and providing 
feedback!

cheers,
dalibor topic

-- 
<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 | 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-Niederlande, Nr. 30143697
Geschäftsführer: Alexander van der Ven, Jan Schultheiss, Val Maher

<http://www.oracle.com/commitment> Oracle is committed to developing
practices and products that help protect the environment