[ https://issues.apache.org/jira/browse/DERBY-3985?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12661075#action_12661075 ]
John H. Embretsen commented on DERBY-3985: ------------------------------------------ When I click the links to BUILDING.html on the web site or the wiki, I get the HTML source as plain text, which is not that easy to read, instead of a rendered HTML page. Not sure if it is browser-dependent; I have tried with Firefox and Opera. I don't know if this is something that could be fixed in SVN. As a workaround, using a different access method (viewvc) seems to do the trick: This displays rendered HTML: http://svn.apache.org/viewvc/db/derby/code/trunk/BUILDING.html?view=co This displays HTML source: http://svn.apache.org/repos/asf/db/derby/code/trunk/BUILDING.html I also would like to note that although the document states that you need JUnit 3.8.1 to run the tests, I think JUnit 3.8.2 works equally well or better (unless I'm overlooking something). Althugh I did not test or read the document's fine details, it looks good, tight and easy to follow. Well done! > Replace BUILDING.txt with a simlified up-to-date BUILDING.html > -------------------------------------------------------------- > > Key: DERBY-3985 > URL: https://issues.apache.org/jira/browse/DERBY-3985 > Project: Derby > Issue Type: Improvement > Components: Build tools > Affects Versions: 10.5.0.0 > Reporter: Rick Hillegas > Assignee: Rick Hillegas > Attachments: derby-3985-01-aa-simplerBuildInstructions.diff, > derby-3985-01-ab-simplerBuildInstructions.diff, > derby-3985-01-ac-simplerBuildInstructions.diff, > derby-3985-02-aa-website.diff, derby-3985-03-aa-corrections.diff > > > At this point, BUILDING.txt contains a number of mis-statements. It is > structured in a way which makes the Derby build look complicated and > intimidating. The build instructions need to be thoroughly overhauled and > divided into two main sections: > 1) The simple build instructions for people who are new to the community. > This will be a build with few pre-requisites which just works out of the box. > 2) Trickier build instructions for people who want compile-time checks for > the different platforms which Derby supports. > While we're at it, I suggest that the revised instructions live in an html > file rather than a flat text file. I think this will result in a document > that is more readable and easier to navigate. -- This message is automatically generated by JIRA. - You can reply to this email to add a comment to the issue online.