Assuming a first level structure like this: Homepage +-- About (http://incubator.apache.org/jena/about/) +-- Download ([...]/download/) +-- Getting Started ([...]/getting-started/) +-- Documentation ([...]/documentation/) +-- Getting Involved|Community ([...]/community/)
Assuming that "Getting Started" is one of the first level section. This thread is about the "Getting Started" section content. Assuming the reader has downloaded Jena, if not, we should point him/her to the "Download" page. Jena has many functionalities and there are many subsystems/modules... ... but, what will we chose as a first 5 minutes (happy) experience for a student who has never used Jena and want to get started? Or, for a software developer working for a large corporation who want to get started? These are some (in my opinion) good examples of "Getting Started" pages of comparable to Jena (in terms of broad range of features or complexity) open source projects: - http://hbase.apache.org/quickstart.html - http://rubyonrails.org/download - http://incubator.apache.org/whirr/quick-start-guide.html - http://code.google.com/p/google-refine/wiki/InstallationInstructions - ... "Getting Started" pages are usually short (if printed, 1 page) and quick: the reader should be able to go from top to bottom in 5-10 minutes. We should clearly state assumption/requirements, such as: - you (reader) should be a developer who has Java installed and who knows how to download, uncompress and run a Java program - you (reader) could use Eclipse IDE and we could provide you with an already set up Eclipse project you can download and run to start with. - ... These two are just two examples/proposals, if people has better ones please suggest. I did not find existing content we could put in the "Getting Started", or, we have too many: getting started with Jena I/O, SPARQL, Inference, TDB, Fuseki, etc. Each one of these could have a "Getting Started" section. Presenting a user who want to get started with a long list of option he/she could get started with would be the wrong choice, in my opinion. I think we should try to chose one "Getting Started". Any proposal? Paolo
