From iris.clark at oracle.com Wed Nov 7 18:24:29 2012 From: iris.clark at oracle.com (Iris Clark) Date: Wed, 7 Nov 2012 18:24:29 -0800 (PST) Subject: Developers' Guide: 0.02 Message-ID: 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/ -------------- next part -------------- An HTML attachment was scrubbed... URL: http://mail.openjdk.java.net/pipermail/guide-discuss/attachments/20121107/4f682254/attachment.html From mike.duigou at oracle.com Wed Nov 7 23:02:36 2012 From: mike.duigou at oracle.com (Mike Duigou) Date: Wed, 7 Nov 2012 23:02:36 -0800 Subject: Developers' Guide: 0.02 In-Reply-To: References: Message-ID: <6F57241C-1A4A-4ED2-B184-B1194C21AE96@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/ -------------- next part -------------- An HTML attachment was scrubbed... URL: http://mail.openjdk.java.net/pipermail/guide-discuss/attachments/20121107/e6de17f2/attachment.html From martijnverburg at gmail.com Thu Nov 8 00:49:36 2012 From: martijnverburg at gmail.com (Martijn Verburg) Date: Thu, 8 Nov 2012 09:49:36 +0100 Subject: Developers' Guide: 0.02 In-Reply-To: <6F57241C-1A4A-4ED2-B184-B1194C21AE96@oracle.com> References: <6F57241C-1A4A-4ED2-B184-B1194C21AE96@oracle.com> Message-ID: 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 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/**** > > > -------------- next part -------------- An HTML attachment was scrubbed... URL: http://mail.openjdk.java.net/pipermail/guide-discuss/attachments/20121108/a4dfad0a/attachment.html From kelly.ohair at oracle.com Thu Nov 8 09:31:33 2012 From: kelly.ohair at oracle.com (Kelly O'Hair) Date: Thu, 8 Nov 2012 09:31:33 -0800 Subject: Developers' Guide: 0.02 In-Reply-To: <6F57241C-1A4A-4ED2-B184-B1194C21AE96@oracle.com> References: <6F57241C-1A4A-4ED2-B184-B1194C21AE96@oracle.com> Message-ID: <2DAD9111-7F1B-45E1-BE2B-5D50524E49F7@oracle.com> +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/ > -------------- next part -------------- An HTML attachment was scrubbed... URL: http://mail.openjdk.java.net/pipermail/guide-discuss/attachments/20121108/bb962afe/attachment-0001.html From cecilia.borg at oracle.com Thu Nov 8 10:17:49 2012 From: cecilia.borg at oracle.com (Cecilia Borg) Date: Thu, 8 Nov 2012 19:17:49 +0100 Subject: Developers' Guide: 0.02 In-Reply-To: <6F57241C-1A4A-4ED2-B184-B1194C21AE96@oracle.com> References: <6F57241C-1A4A-4ED2-B184-B1194C21AE96@oracle.com> Message-ID: Totally agree, thanks Iris for putting some love into this :) Cecilia 8 nov 2012 kl. 08:02 skrev Mike Duigou : > 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/ > -------------- next part -------------- An HTML attachment was scrubbed... URL: http://mail.openjdk.java.net/pipermail/guide-discuss/attachments/20121108/8100757a/attachment.html From iris.clark at oracle.com Thu Nov 15 19:16:52 2012 From: iris.clark at oracle.com (Iris Clark) Date: Thu, 15 Nov 2012 19:16:52 -0800 (PST) Subject: FW: Developers' Guide: 0.02 In-Reply-To: <50A55BE2.8020902@oracle.com> References: <50A55BE2.8020902@oracle.com> Message-ID: <06649040-e933-4f0a-a058-62c35ccc3727@default> Hi, Dmitry. The source for the guide specifies encoding="iso-8859-1". The XSL stylesheet for openjdk.java.net specifies "us-ascii" so that's what the majority[1] of the entire site's .html uses, regardless of what's specified. iris [1]: JavaDoc .html files aren't processed. -----Original Message----- From: Dmitry Samersoff Sent: Thursday, November 15, 2012 1:17 PM To: Tuva Palm Cc: svc-internal_ww_grp; Oleg Pekhovskiy; Shanliang Jiang; Jean-Francois Denise; Gerard Ziemski; guide-discuss at openjdk.java.net; Iris Clark Subject: Re: FW: Developers' Guide: 0.02 Iris, What is the reason of using us-ascii but not utf-8 ? -Dmitry On 2012-11-15 14:09, Tuva Palm wrote: > FYI? > > > > *From: *Iris Clark > > > *Subject: Developers' Guide: 0.02* > > *Date: *November 7, 2012 6:24:29 PM PST > > *To: *guide-discuss at openjdk.java.net > > > > > 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/ > > > -- Dmitry Samersoff Oracle Java development team, Saint Petersburg, Russia * Give Rabbit time, and he'll always get the answer From iris.clark at oracle.com Mon Nov 19 18:53:04 2012 From: iris.clark at oracle.com (Iris Clark) Date: Mon, 19 Nov 2012 18:53:04 -0800 (PST) Subject: FW: Developers' Guide: 0.02 In-Reply-To: <50A5EC97.9090802@oracle.com> References: <50A55BE2.8020902@oracle.com> <06649040-e933-4f0a-a058-62c35ccc3727@default> <50A5EC97.9090802@oracle.com> Message-ID: <83c4b731-d06a-4c66-9dff-b58fc6762b53@default> Hi, Dmitry. I've done some digging. "us-ascii' was selected for portability, ease of inspection/editing, and ease of processing by non-UTF-8-capable tools. There are no plans to change the encoding for the OpenJDK website. iris -----Original Message----- From: Dmitry Samersoff Sent: Thursday, November 15, 2012 11:35 PM To: Iris Clark Cc: Tuva Palm; svc-internal_ww_grp; Oleg Pekhovskiy; Shanliang Jiang; Jean-Francois Denise; Gerard Ziemski; guide-discuss at openjdk.java.net Subject: Re: FW: Developers' Guide: 0.02 Iris, Thank you for clarification. I'm not familiar with doc process, so please forgive my ignorance. One think makes me worried - when I switch from translated (utf-8) to not translated (us-ascii) page it requires browser to switch encoding. Browsers doesn't do it correct always, especially on mobile devices. So I would prefer to use the same, utf-8 encoding, across all docs if it possible. -Dmitry On 2012-11-16 07:16, Iris Clark wrote: > Hi, Dmitry. > > The source for the guide specifies encoding="iso-8859-1". The XSL stylesheet for openjdk.java.net specifies "us-ascii" so that's what the majority[1] of the entire site's .html uses, regardless of what's specified. > > iris > > [1]: JavaDoc .html files aren't processed. > > -----Original Message----- > From: Dmitry Samersoff > Sent: Thursday, November 15, 2012 1:17 PM > To: Tuva Palm > Cc: svc-internal_ww_grp; Oleg Pekhovskiy; Shanliang Jiang; > Jean-Francois Denise; Gerard Ziemski; guide-discuss at openjdk.java.net; > Iris Clark > Subject: Re: FW: Developers' Guide: 0.02 > > Iris, > > What is the reason of using us-ascii but not utf-8 ? > > -Dmitry > > > On 2012-11-15 14:09, Tuva Palm wrote: >> FYI? >> >> >> >> *From: *Iris Clark > > >> >> *Subject: Developers' Guide: 0.02* >> >> *Date: *November 7, 2012 6:24:29 PM PST >> >> *To: *guide-discuss at openjdk.java.net >> >> >> >> >> 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/ >> >> >> > > > -- > Dmitry Samersoff > Oracle Java development team, Saint Petersburg, Russia > * Give Rabbit time, and he'll always get the answer > -- Dmitry Samersoff Oracle Java development team, Saint Petersburg, Russia * Give Rabbit time, and he'll always get the answer