Thanks very much for getting this done. I am playing naive new user. I checked out the svn files, and viewed README.md. Note that it might be nice to provide it as a README.txt as well - a user who is getting the code from SVN may not be familiar with Github conventions.
I think the instructions need a bit more information: "To build the examples, simply unpack the source distribution of 'river-examples', and then, cd river-examples mvn install mvn site" What am I supposed to unpack? How do I unpack it? It should say where to type this. Windows command tool? Cygwin shell? Unix/Linux shell? I assume I need a JDK, but that should be specified. Which JDK versions? I skipped the "unpack" part of the instructions and used Netbeans. I created a new Maven project from existing POM, and built it. I then used right click on project, Custom, Goals to run "install" and "site". That all worked fine, including smoothly downloading from Maven Central. I opened the index.html file that resulted. Clicking on e.g. the "browser" link got "Firefox can't find the file at /C:/river-examples/target/site/browser/index.html.". The browser directory contains a file "browser-start.png" but no "index.html". Thanks again for your efforts. Patricia On 2/7/2015 6:27 AM, Greg Trasuk wrote:
Hi all: This doesn’t seem to have gone through the mail system yesterday, so I’m posting again. Apologies if we eventually have a storm of similar messages. Hi all: Finally finished the examples project. Please review and comment. You can get it from svn at https://svn.apache.org/repos/asf/river/river-examples/river-examples/trunk My thinking is that a new user trying out the examples will start with the read me file at: “README.md” (formatted as markdown so that in case someone is looking at the github mirror, they’ll see it on the front page of the project). So, if one or more of you could checkout the project and begin by following the README.md instructions, that would give us a feel for the “new-user” experience. I’m picturing that we should be able to release the examples project fairly quickly, and then start trying to publicize it. Also, we can add more advanced examples as time goes on (e.g. event notifications, transactions, JavaSpaces, web app client, etc). Thanks, Greg Trasuk.
