Since the domain will also ideally move, there is no reason to put the temporary URL to the version of the document that will appear here. The link is in the original thread if you need it.
Joined: Aug 05, 2010
Jeanne Boyarsky wrote:Step one completed: (document available at coderanch URL)
It is looking like a very faithful reproduction. Now we need to trim some things, make a few updates and make it 'at home' here.
I'd remove the row of links at the top. They really serve no purpose, given the list almost immediately below.
The last three sections: Contributors, Promoters & Version History as well as..
The Bibliography (that information could be in-lined where the term is defined)
All the 'bottom' of page links to mirrors etc. (one mirror at algafield seems to have disappeared, and the other won't be a mirror for long).
Under Short section "stop reading by 20Kb, and start complaining at 30Kb.". That is a wildly huge amount of code to call 'short'. It should be changed from Kb to 'lines of code', but how should those values be adjusted? I think the upper limit should be based upon, and refer to, how much code a user of Java Ranch/Code Ranch can actually post in a question. I cannot speak for this forum, but another popular forum seems to hit a limit in around 600 to 650 lines of (properly formatted) code. The 'stop reading' part can probably be stated as 200 lines of code.
Under the Correct section, remove the 2nd paragraph of the first point that refers to the Text Width Checker Java tool. Doing text width checks is easy in most editors designed for editing code/HTML. Plus the entire PSCode.org will probably be disappearing (as was the fate for the SSCCE until the kind offer from Java Ranch to provide it a home on the Wiki)
The same applies to the SSCCE Text Based Compiler mentioned in the 3rd point.
Rework it to remove every reference of "I", "I'm" etc. to a "we" or alternate wording. Sections to look at are Example - Extra Points, and the emboldened section near the end of Why bother?
How does a page gain the usual Wiki page wrapper and styles?
Our first goal is transfer the domain. Then we decide if we want to keep it as an HTML page (with CodeRanch styling) or make it a wiki page with a redirect to the new page. We'll probably decide that in March.
Priority one is to make sure the page doesn't disappear!