Win a copy of Design for the Mind this week in the Design forum!
  • Post Reply
  • Bookmark Topic Watch Topic
  • New Topic

What do y'all think

 
Marilyn de Queiroz
Sheriff
Posts: 9059
12
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
of the new shorter JavaRanch Style Guide?
 
Joyce Lee
Ranch Hand
Posts: 1392
  • Mark post as helpful
  • send pies
  • 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 ]
     
    dav mccartney
    Ranch Hand
    Posts: 45
    • Mark post as helpful
    • send pies
    • 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 ]
     
    Pauline McNamara
    Sheriff
    Posts: 4012
    6
    • Mark post as helpful
    • send pies
    • 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: 9059
    12
    • Mark post as helpful
    • send pies
    • 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
    • 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: 9059
    12
    • Mark post as helpful
    • send pies
    • 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.
     
    • Post Reply
    • Bookmark Topic Watch Topic
    • New Topic