I've been going back over the previous discussion on the architecture
for the migrated documentation site, and have a proposal which, afaict,
consolidates the previous suggestions and works with the Apache CMS. I
have a working version of the structure on my test site - once we've
kicked the proposal below around a bit, I'll commit it into SVN which
will make it available on the staging server. We can then edit it into
initial shape, and publish to the public site.
I propose that we don't wait until absolutely everything has migrated
over - it will take some time to get all the words in the right place
and edited. However, once it's good enough we can start to get some
public visibility, feedback, patches etc.
Suggested structure for the site is attached. Demo version at:
http://iandickinson.me.uk/jena
Ian
Section-name nav tab file location
------------ ------- -------------
pagename
--------
+-- Quick links
+-- Home /index.html
+-- Downloads /download/index.html
+-- Support
/help_and_support/index.html
+-- Report a bug
/support/bugs_and_suggestions.html
+-- Roadmap /about/roadmap.html
+-- About Jena
+-- Home about /index.html (default
page)
+-- What is Jena? about /about_jena(/index.html)
+-- Roadmap /about_jena/roadmap.html
+-- Project team /about_jena/team.html
+-- Download
+-- Downloading Jena download /download(/index.html)
+-- Using Maven /download/maven.html
+-- Using OSGi /download/osgi.html
+-- Help and support
+-- Getting help help & support
/help_and_support(/index.html)
+-- Bugs and suggestions
/help_and_support/bugs_and_suggestions.html
+-- FAQ
/help_and_support/faq.html
+-- Getting Started
+-- A first Jena project getting started
/getting_started(/index.html)
+-- RDF API overview
/getting_started/api.html
+-- Querying RDF with SPARQL
/getting_started/sparql.html
+-- Serving RDF over HTTP
/getting_started/fuseki.html
+-- Tell me how to ...
/getting_started/tell_me_how_to.html
+-- Tutorials
+-- RDF tutorial tutorials /tutorials(/index.html)
+-- SPARQL queries /tutorials/sparql.html
+-- Using Jena with Eclipse
/tutorials/using_jena_with_eclipse.html
+-- Documentation
+-- Overview documentation
/documentation(/index.html)
+-- Javadoc /documentation/javadoc
+-- RDF
/documentation/rdf(/index.html)
+-- Query
/documentation/query(/index.html)
+-- TDB
/documentation/tdb(/index.html)
+-- SDB
/documentation/sdb(/index.html)
+-- Serving Data
/documentation/serving_data(/index.html)
+-- Ontology
/documentation/ontology(/index.html)
+-- Principles
/documentation/ontology/principles.html
+-- Ontology API
/documentation/ontology/ontology_api
+-- Code examples
/documentation/ontology/code_examples
+-- Inference
/documentation/inference(/index.html)
+-- Tools
/documentation/tools(/index.html)
+-- Getting Involved
+-- Contributing to Jena getting involved
/getting_involved(/index.html)