incubator-jena-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Dave Reynolds <>
Subject Re: Jena documentation - new structure working notes
Date Fri, 18 Feb 2011 11:49:28 GMT
On Fri, 2011-02-18 at 11:00 +0000, Chris Dollin wrote: 
> I don't (currently) have a strong opinion on the details
> of a new Jena documentation structure.
> But as to content I do; we should have as our /primary/
> (not our /only/) focus the beginners, the occasional users,
> the people who are using Jena (the family) as a tool, not
> as an interesting development exercise.
> My reasoning is that the beginners are the people who will give 
> up and turn elsewhere if they can't find what they need to know, 
> and find it quickly and effectively. More experienced developers will
> know (how) to dig around, be willing to post messages to the
> lists, to know that they have to /work/ to learn the details [1].
> The beginners don't have those skills (yet).
> Things we do to help beginners find their way round Jena's
> documentation and code will help experienced developers
> as well. The converse doesn't seem to me to be as usefully
> true.



View raw message