Marty, Thanks for the suggestions. We'll incorporate them into our next doc review/update.
Keep 'em coming. - Chris On Wed, Dec 23, 2009 at 5:27 PM, Marty Hall <javahac...@gmail.com> wrote: > I have been in Asia the last month doing training, so this is my first > look at the new (yay!) GWT 2.0 docs. GWT 2.0 looks great, but I did > notice a few small errors in the docs: > > http://code.google.com/webtoolkit/gettingstarted.html > ========================= > > A) Under "Create your first Web application": > "create a new application called MyApplication" should be "create a > new application called MyWebApp". Also, I would suggest also saying > something like "if you use the Eclipse plugin described later in this > document, you can also do File > New > Web Application Project and > then interactively specify a package name". > > B) Under "Run locally in development mode": > The sentence "Since this is your first time hitting the development > mode server..." is slightly inaccurate since the real issue is if it > is the first time PER BROWSER. I would suggest something like "The > first time you use a browser with the development mode server, it will > prompt..." Also, I again suggest that you list the Eclipse Plugin > command for running in development mode (R-click project, Debug As > > Web Application). > > C) Under "Make a few changes": > In the first paragraph, "java files" should be "Java files". Also, the > last part of that same sentence ("in the case of this Quick Start...") > does not parse and needs to be reworded. Finally, in the last > sentence, change the colon after "Send" to a period. > > D) Under "Setting up an IDE": > Since there is support only for Eclipse, I would change the title to > "Using the Eclipse Plugin" or "Eclipse Support" or some such. Also, > there should be a comma after "IDE" in the first sentence. Also, I'd > insert here a very short summary of what the Eclipse plugin does for > you. I would think the majority of users would use the plugin, but > this document somewhat implies that the command line is the normal > approach and the Eclipse plugin is an afterthought. > > http://code.google.com/webtoolkit/doc/latest/ReleaseNotes.html > ========================= > > A) Under "Bug Fixes": > Issue 1574: #remoteCookie should be #removeCookie. Issue 3102: > #removeHandelr should be #removeHandler, and "has be" should be "has > been". Issue 3903: "pages no contain" should be something like "pages > no longer contain" or "pages do not contain". > > B) Under "HtmlUnit and Test Cases": > In second bullet, change "continous" to "continuous". > > C) Under "Problems?": > Add comma after "GWT Developer Forum". > > http://code.google.com/eclipse/docs/using_sdks.html > ========================= > > A) I would be a bit more clear that you should select "Web Toolkit" > and point at the new GWT 2.0 installation. For those upgrading from > GWT 1.7, that is the part you have to change. The current screen shots > show only the App Engine part, which does not need to change. > > http://code.google.com/webtoolkit/usingeclipse.html > ========================= > > A) For those upgrading from GWT 1.x, I would make it a bit more clear > that you have to download GWT 2.0 separately. Previously, downloading > the Eclipse plugin also gave you GWT, with no separate download > required. > > B) Under "Create a Web Application", change "java package" to "Java > package". > > C) Under "Run locally in Development Mode", this description of when > you will be prompted for the browser plugin is what I would like to > see under the same heading in > http://code.google.com/webtoolkit/gettingstarted.html. > > D) Under "Make a Few Changes", change "java files" to "Java files". > > I am very pleased to see GWT 2.0 out. Keep up the great work! > > - Marty > http://www.coreservlets.com/ > > -- > > You received this message because you are subscribed to the Google Groups > "Google Web Toolkit" group. > To post to this group, send email to google-web-tool...@googlegroups.com. > To unsubscribe from this group, send email to > google-web-toolkit+unsubscr...@googlegroups.com<google-web-toolkit%2bunsubscr...@googlegroups.com> > . > For more options, visit this group at > http://groups.google.com/group/google-web-toolkit?hl=en. > > > -- You received this message because you are subscribed to the Google Groups "Google Web Toolkit" group. To post to this group, send email to google-web-tool...@googlegroups.com. To unsubscribe from this group, send email to google-web-toolkit+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/google-web-toolkit?hl=en.
