aspose file tools*
The moose likes Ranch Office and the fly likes SSCCE will soon be moving right here to the Wiki! Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login
JavaRanch » Java Forums » This Site » Ranch Office
Bookmark "SSCCE will soon be moving right here to the Wiki!" Watch "SSCCE will soon be moving right here to the Wiki!" New topic
Author

SSCCE will soon be moving right here to the Wiki!

Andrew Thompson
Ranch Hand

Joined: Aug 05, 2010
Posts: 77
    
    5
After discussions with Jeanne Boyarsky on The SSCCE.org document will soon be disappearing, it seems set that the SSCCE will be moving right here to the Wiki.

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.


Andrew Thompson
http://pscode.org/
Andrew Thompson
Ranch Hand

Joined: Aug 05, 2010
Posts: 77
    
    5
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.

Trimming:

  • 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).


  • Updates:

  • 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?


  • At home:

  • How does a page gain the usual Wiki page wrapper and styles?
  • Jeanne Boyarsky
    author & internet detective
    Marshal

    Joined: May 26, 2003
    Posts: 31073
        
    232

    Andrew,
    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!


    [Blog] [JavaRanch FAQ] [How To Ask Questions The Smart Way] [Book Promos]
    Blogging on Certs: SCEA Part 1, Part 2 & 3, Core Spring 3, OCAJP, OCPJP beta, TOGAF part 1 and part 2
    Andrew Thompson
    Ranch Hand

    Joined: Aug 05, 2010
    Posts: 77
        
        5
    Jeanne Boyarsky wrote:..We'll probably decide that in March.


    Yes, that is fine. No rush.
    Jeanne Boyarsky
    author & internet detective
    Marshal

    Joined: May 26, 2003
    Posts: 31073
        
    232

    Yes, I meant March . Edited that in.
    Jeanne Boyarsky
    author & internet detective
    Marshal

    Joined: May 26, 2003
    Posts: 31073
        
    232

    We decided to leave the doc as is rather than move it to the wiki. At least for the time being.

    We just changed the hosting info at the bottom to reflect our hosting provider and a coderanch link.
    Andrew Thompson
    Ranch Hand

    Joined: Aug 05, 2010
    Posts: 77
        
        5
    Jeanne Boyarsky wrote:..We just changed the hosting info..


    That is subtle.

    How about I provide as (code formatted) text, an HTML 5 validated version of the document with the changes I suggested earlier, but keeping the new hosting info.?

    HTML 5 is definitely the way forward.
    Jeanne Boyarsky
    author & internet detective
    Marshal

    Joined: May 26, 2003
    Posts: 31073
        
    232

    Andrew Thompson wrote:That is subtle.

    It was the smallest change we could make to check the DNS was updated.

    Andrew Thompson wrote:How about I provide as (code formatted) text, an HTML 5 validated version of the document with the changes I suggested earlier, but keeping the new hosting info.?

    Sure. My biggest problem at the moment is lack of time. If you send the new page to me, I'll replace it.
    Andrew Thompson
    Ranch Hand

    Joined: Aug 05, 2010
    Posts: 77
        
        5
    Jeanne Boyarsky wrote:
    Andrew Thompson wrote:How about I provide as (code formatted) text, an HTML 5 validated version of the document with the changes I suggested earlier, but keeping the new hosting info.?

    Sure. My biggest problem at the moment is lack of time. If you send the new page to me, I'll replace it.


    Stats

    Statistics comparing the old and new forms of the document. The new document is around 40% less 'page downs' and over 50% less to download.



    Source

    The HTML 5 (validated) source of the newer form.

    Jeanne Boyarsky
    author & internet detective
    Marshal

    Joined: May 26, 2003
    Posts: 31073
        
    232

    Thank you for making this a trivial activity for me. I've uploaded the new page.

    And interesting stats on the page size!
    Andrew Thompson
    Ranch Hand

    Joined: Aug 05, 2010
    Posts: 77
        
        5
    Jeanne Boyarsky wrote:Thank you for making this a trivial activity for me.


    Thanks for your efforts at getting it to its new home.

    Jeanne Boyarsky wrote:I've uploaded the new page.


    Yes, that looks good.

    How is the domain transfer & address redirection coming along? I'm still seeing the old document at SSCCE.org.
    Andrew Thompson
    Ranch Hand

    Joined: Aug 05, 2010
    Posts: 77
        
        5
    Andrew Thompson wrote:How is the domain transfer & address redirection coming along? I'm still seeing the old document at SSCCE.org.


    I am now seeing the new version of the document at SSCCE.org.
    Jeanne Boyarsky
    author & internet detective
    Marshal

    Joined: May 26, 2003
    Posts: 31073
        
    232

    Andrew Thompson wrote:How is the domain transfer & address redirection coming along? I'm still seeing the old document at SSCCE.org.

    I guess we are using different DNS servers. I've been seeing our version for days. The important thing is that everyone sees it by March 1st when your version goes down!
    Andrew Thompson
    Ranch Hand

    Joined: Aug 05, 2010
    Posts: 77
        
        5
    Jeanne Boyarsky wrote:I've been seeing our version for days.


    Admittedly, I have only been checking it on & off. OTOH I am in Australia and it takes a while for the changes to 'trickle through' the DNS chain.

    Jeanne Boyarsky wrote:The important thing is that everyone sees it by March 1st when your version goes down!


    (checks watch) I'd guess we're well placed to see that happen. Good work.

     
    I agree. Here's the link: http://aspose.com/file-tools
     
    subject: SSCCE will soon be moving right here to the Wiki!