[Mulgara-general] Finding documentation

[David Wood]

Hi Peter,

Thank you for your important contribution.  You are absolutely  
correct - the documentation needs work.  The community includes a  
number of people who have been using the system for long enough that  
we tend to forget new users.  That is clearly our error and one that  
I will help to remedy.

What kind of documentation would you most like to see?  A "getting  
started" guide?  That seems like a fairly easy thing to create and  
something that would provide good value.  Any information on material  
you would like to see will speed that process and make it more likely  
to help others.  Thanks again.

Regards,
Dave


On 27 Jul2007, at 21:24, Peter Becker wrote:

> Hello all,
>
> I don't want to sound too whingy, but I had a really hard time  
> finding the
> documentation for Mulgara, since the "Documentation" link at the  
> top of
> http://mulgara.org only points down on the main page, which links  
> to the
> Wiki, which doesn't mention the documentation at docs.mulgara.org  
> until three
> clicks in (or at least I couldn't find it faster). I didn't notice  
> the links
> on the left hand side until the third time around since they are  
> very laid
> back and I just didn't expect two left hand navigations. The first  
> time round
> I actually went away and tried Jena instead -- I needed something  
> quickly for
> some prototyping and didn't feel like hunting down documentation, I  
> was just
> looking for a basic quick start document to start trying stuff.
>
> After two people talked me into checking out Mulgara again (still  
> prototyping,
> so I still don't really care that much) I found that link, but I  
> think it is
> very hard to notice. I actually asked my wife to point out all  
> things to do
> on that page and she pointed to the two text-based navigations and  
> then
> said "and maybe this", pointing to the graphical links on the far  
> left. At
> least it doesn't seem to be just me having problems identifying  
> these links,
> so I thought I mention it here. There might be more people turning  
> their back
> on the project due to the perceived lack of documentation as I did  
> in the
> first round.
>
> Cheers,
>    Peter
> _______________________________________________
> Mulgara-general mailing list
> Mulgara-general at mulgara.org
> http://mulgara.org/mailman/listinfo/mulgara-general
>