• Post Reply Bookmark Topic Watch Topic
  • New Topic
programming forums Java Mobile Certification Databases Caching Books Engineering Micro Controllers OS Languages Paradigms IDEs Build Tools Frameworks Application Servers Open Source This Site Careers Other Pie Elite all forums
this forum made possible by our volunteer staff, including ...
Marshals:
  • Campbell Ritchie
  • Jeanne Boyarsky
  • Ron McLeod
  • Paul Clapham
  • Liutauras Vilda
Sheriffs:
  • paul wheaton
  • Rob Spoor
  • Devaka Cooray
Saloon Keepers:
  • Stephan van Hulst
  • Tim Holloway
  • Carey Brown
  • Frits Walraven
  • Tim Moores
Bartenders:
  • Mikalai Zaikin

What do y'all think

 
Sheriff
Posts: 9109
12
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
of the new shorter JavaRanch Style Guide?
 
Ranch Hand
Posts: 1392
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
I prefer the old version for the following reasons:
  • it has a table of content that link to the respective section
  • everything is within a page
  • I actually saved the old version on my pc. So whenever I want to refer the coding convention, I don't have to log on to the internet. Since there's only 1 html page, it's easy for me to refer.


  • Joyce
    [ August 28, 2004: Message edited by: Joyce Lee ]
     
    Ranch Hand
    Posts: 45
    • Mark post as helpful
    • send pies
      Number of slices to send:
      Optional 'thank-you' note:
    • Quote
    • Report post to moderator
    The new guide looks good... and much less intimidating! Are you trying to *not* scare people away with it?

    I agree with Joyce and her reason for printing. I have the "old" version of the guide printed out entirely, which is much easier to do with the older format. Perhaps this could be addressed by providing some sort of printed version in a PDF format? (Anyone that uses a OS X could do the PDFing for you... and I happen to use OS X )

    As for the index, I don't actually miss that portion of it. I typically search for my term instead of browsing the index for it. Which also means I don't refer to the printed version I have that often... which also could be a bit harder to do in the newer format as well (but only time will tell).
    [ August 28, 2004: Message edited by: dav mccartney ]
     
    Sheriff
    Posts: 4012
    6
    • Mark post as helpful
    • send pies
      Number of slices to send:
      Optional 'thank-you' note:
    • Quote
    • Report post to moderator
    Looks cleaner, that's nice. I wonder if it will be easier to actually use. I often did a search on the one page version, that was pretty convenient.

    Did any of the rules change? I couldn't find the exception to the spacing rule around casts.
     
    Marilyn de Queiroz
    Sheriff
    Posts: 9109
    12
    • Mark post as helpful
    • send pies
      Number of slices to send:
      Optional 'thank-you' note:
    • Quote
    • Report post to moderator
    Good point, Pauline. The exceptions are on the Examples and Reasoning page rather than on the original page. Probably at least the statement that there are exceptions to the rule should be on the main page.
     
    Pauline McNamara
    Sheriff
    Posts: 4012
    6
    • Mark post as helpful
    • send pies
      Number of slices to send:
      Optional 'thank-you' note:
    • Quote
    • Report post to moderator
    Yeah, I saw the exceptions, but not the one about casts. Has that been changed?
     
    Marilyn de Queiroz
    Sheriff
    Posts: 9109
    12
    • Mark post as helpful
    • send pies
      Number of slices to send:
      Optional 'thank-you' note:
    • Quote
    • Report post to moderator
    Ah Ha! I see the problem. There were two original style guide pages that were not identical. I'll get that casting stuff moved over. Thanks for catching that, Pauline.
     
    With a little knowledge, a cast iron skillet is non-stick and lasts a lifetime.
    reply
      Bookmark Topic Watch Topic
    • New Topic