What do y'all think

[Marilyn de Queiroz]

of the new shorter JavaRanch Style Guide?

[Joyce Lee]

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]

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]

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]

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]

Yeah, I saw the exceptions, but not the one about casts. Has that been changed?

[Marilyn de Queiroz]

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.