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)


Reply via email to