On Fri, 2011-02-18 at 12:37 +0000, Paolo Castagna wrote: > > Dave Reynolds wrote:
> > Does a consolidated suggestion like this work? > > > > +-- About > > +-- Download > > [Includes Maven] > > +-- Getting started > > [Small number of short guides.] > > +-- Tutorials > > [Would include topic tutorial (such as the existing RDF & SPARQL > > ones) as well as cross-cutting tutorials (such as Ian's working > > with Jena under Eclipse)] > > [I would also put the critical HOW TOs here (IO, Frames, > > Assembler) but they could be in a section under the detailed > > documentation] > > +-- Documentation > > +-- javadoc > > +-- RDF > > +-- Query > > +-- TDB > > +-- SDB > > +-- Serving data (Fuseki) > > +-- Ontology > > +-- Inference > > +-- tools > > +-- extras > > +-- Community > > [Should include roadmap, guidance on patch submission, links to > > trackers etc.] > > +-- News > > I can be happy with that. Great. > As a user landing on a project which gives me the choice between "Tutorials" > and "Documentation" I would probably ask myself "why "Tutorials" are not > below "Documentation""? But, it's not a big problem. Happy to pick a better title (we previously suggested In Depth). Having found myself as a beginner tying to use various (Ruby) libraries this last two weeks I've found separate Tutorials sections to be useful and quite common. Typically the getting started is enough to install and do hello world but not enough to understand what's going on. Documentation is often, like ours, dominated by API level documentation and details that assume you have the overall picture in your head, it is easy to get lost in until have a start at understanding the tool. Tutorials bridge that gap. > I am not sure what you intend to put in Documentation/RDF. I was following Ian's suggested naming, basically the core API. Our main material at the level at the moment is the RDF Tutorial and some HOW TOs so depending on how we treat the HOW TOs it may be ... thin ... to begin with :) > I am happy the "Community" page is there, but my preferred labeling would > be "Getting Involved" since it is aligned to "Getting Started" and somehow > imply an active role from the user, a think I want to increase. Fine by me. I've seen both used reasonably equally. > I have already commented about News. But, I have no strong opposition to it. Happy to go along with you an Andy on that. A news section must be active and up to date otherwise it is a negative. Better to have no section rather than something poor. Dave
