aspose file tools*
The moose likes Cattle Drive and the fly likes What do y'all think Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login
JavaRanch » Java Forums » This Site » Cattle Drive
Bookmark "What do y Watch "What do y New topic
Author

What do y'all think

Marilyn de Queiroz
Sheriff

Joined: Jul 22, 2000
Posts: 9053
    
  12
of the new shorter JavaRanch Style Guide?


JavaBeginnersFaq
"Yesterday is history, tomorrow is a mystery, and today is a gift; that's why they call it the present." Eleanor Roosevelt
Joyce Lee
Ranch Hand

Joined: Jul 11, 2003
Posts: 1392
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

    Joined: Feb 22, 2004
    Posts: 45
    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

    Joined: Jan 19, 2001
    Posts: 4012
        
        6
    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

    Joined: Jul 22, 2000
    Posts: 9053
        
      12
    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

    Joined: Jan 19, 2001
    Posts: 4012
        
        6
    Yeah, I saw the exceptions, but not the one about casts. Has that been changed?
    Marilyn de Queiroz
    Sheriff

    Joined: Jul 22, 2000
    Posts: 9053
        
      12
    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.
     
    I agree. Here's the link: http://aspose.com/file-tools
     
    subject: What do y'all think