Hi! Just thought I'd let you know that I just pushed an update to the Guide [1] (webrev [2]). Don't get too excited, all I did was a quick pass to remove the obviously incorrect (e.g. s/Sun/Oracle/g), eliminate references to plans that never materialized or things that longer exist, run it through the W3C Markup Validator, and bump the version number/date. There's still additional work that could be done. There's no grand plan here. It just made me sad to see the Guide languishing for attention. Thanks, iris [1]: http://openjdk.java.net/guide/ [2]: http://cr.openjdk.java.net/~iris/guide/20121107/
This kind of change may seem minor but it does make a very positive difference. New users approaching the project are undoubtably put off or made nervous seeing very stale documents. Out of date docs really kill confidence that a project is a "going concern". Mike On Nov 7 2012, at 18:24 , Iris Clark wrote:
Hi!
Just thought I’d let you know that I just pushed an update to the Guide [1] (webrev [2]). Don’t get too excited, all I did was a quick pass to remove the obviously incorrect (e.g. s/Sun/Oracle/g), eliminate references to plans that never materialized or things that longer exist, run it through the W3C Markup Validator, and bump the version number/date.
There’s still additional work that could be done. There’s no grand plan here. It just made me sad to see the Guide languishing for attention. Thanks, iris
[1]: http://openjdk.java.net/guide/ [2]: http://cr.openjdk.java.net/~iris/guide/20121107/
Hi all, Great stuff, good to see this getting updated! When further work is planned please do let me know - we have a quite a stack of documentation building up in the Adopt OpenJDK project, especially around working with source code on modern IDEs, we'd love to see this sort of thing move into OpenJDK proper. Cheers, Martijn On 8 November 2012 08:02, Mike Duigou <mike.duigou@oracle.com> wrote:
This kind of change may seem minor but it does make a very positive difference. New users approaching the project are undoubtably put off or made nervous seeing very stale documents. Out of date docs really kill confidence that a project is a "going concern".
Mike
On Nov 7 2012, at 18:24 , Iris Clark wrote:
Hi!**** ** ** Just thought I’d let you know that I just pushed an update to the Guide [1] (webrev [2]). Don’t get too excited, all I did was a quick pass to remove the obviously incorrect (e.g. s/Sun/Oracle/g), eliminate references to plans that never materialized or things that longer exist, run it through the W3C Markup Validator, and bump the version number/date. **** ** ** There’s still additional work that could be done. There’s no grand plan here. It just made me sad to see the Guide languishing for attention.**** **** Thanks,**** iris**** ** ** [1]: http://openjdk.java.net/guide/**** [2]: http://cr.openjdk.java.net/~iris/guide/20121107/****
+1 Thanks Iris! -kto On Nov 7, 2012, at 11:02 PM, Mike Duigou wrote:
This kind of change may seem minor but it does make a very positive difference. New users approaching the project are undoubtably put off or made nervous seeing very stale documents. Out of date docs really kill confidence that a project is a "going concern".
Mike
On Nov 7 2012, at 18:24 , Iris Clark wrote:
Hi!
Just thought I’d let you know that I just pushed an update to the Guide [1] (webrev [2]). Don’t get too excited, all I did was a quick pass to remove the obviously incorrect (e.g. s/Sun/Oracle/g), eliminate references to plans that never materialized or things that longer exist, run it through the W3C Markup Validator, and bump the version number/date.
There’s still additional work that could be done. There’s no grand plan here. It just made me sad to see the Guide languishing for attention. Thanks, iris
[1]: http://openjdk.java.net/guide/ [2]: http://cr.openjdk.java.net/~iris/guide/20121107/
Totally agree, thanks Iris for putting some love into this :) Cecilia 8 nov 2012 kl. 08:02 skrev Mike Duigou <mike.duigou@oracle.com>:
This kind of change may seem minor but it does make a very positive difference. New users approaching the project are undoubtably put off or made nervous seeing very stale documents. Out of date docs really kill confidence that a project is a "going concern".
Mike
On Nov 7 2012, at 18:24 , Iris Clark wrote:
Hi!
Just thought I’d let you know that I just pushed an update to the Guide [1] (webrev [2]). Don’t get too excited, all I did was a quick pass to remove the obviously incorrect (e.g. s/Sun/Oracle/g), eliminate references to plans that never materialized or things that longer exist, run it through the W3C Markup Validator, and bump the version number/date.
There’s still additional work that could be done. There’s no grand plan here. It just made me sad to see the Guide languishing for attention. Thanks, iris
[1]: http://openjdk.java.net/guide/ [2]: http://cr.openjdk.java.net/~iris/guide/20121107/
participants (5)
-
Cecilia Borg
-
Iris Clark
-
Kelly O'Hair
-
Martijn Verburg
-
Mike Duigou