Getting out... -> docs

[Jeff Justice]

I would also like to point out that we've been down this road before.   
Search through the list archives.  You'll see that I have mentioned  
documentation several times along with other people.  There was even  
talk from Paradigma of improving it, several people volunteered their  
help, and yet here we are having the same discussion.

And people wonder why I'm frustrated with Valentina.  If you want  
specifics, why not just have a look at RealSQLServer's docs.  That's  
the kind of straightforward easy to read documentation I'm talking  
about.  Ruslan, I'd be happy to email it to you for a look if you like.

Jeff J.


On Feb 12, 2008, at 1:04 PM, Joseph Morgan wrote:

> I have to agree with Betrix,
>
> Improving the docs will help you get more new users. Many people are  
> probably downloading the demos and getting lost. Then they give up  
> too soon to realize that it's a good product
>
> Joseph Morgan
>
> On Feb 12, 2008, at 11:05 AM, Ruslan Zasukhin wrote:
>
>> On 12/2/08 6:40 PM, "Beatrix Willius" <bwillius at gmx.de> wrote:
>>
>> Hi Beatrix,
>>
>> Well, you know many years that I am not against of critic of  
>> Valentina.
>> Right?
>>
>> But critic which is helpful and constructive. Questions when they are
>> questions, but not just a cry "how bad it is", always answered,  
>> right?
>>
>> You have tell us about problems of docs. Well.
>> I want ask you personally, Beatrix,
>>
>>   GIVE US at least 10 TOP points which are bad in docs.
>>   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>>
>> And we will explain that ASAP.
>>
>> Phrase -- wiki is MESS is useless.
>>   describe what troubles you have and why.
>>   and then only we will be able try to fix that.
>>
>> In contrast I quite often get from new-comers words:
>>   I do not have questions, docs are *excellent*.
>>
>> So as always, how much people, so much opinions around.
>>
>> If you personally have troubles, just describe that in DETAILED form,
>>   and even better report them into Mantis.
>>
>>
>>
>>> Ruslan,
>>>
>>> you are a developer, who uses his own product every day. A newcomer
>>> just wants the new software he/she purchased to work. Valentina is a
>>> great product. But how many times are there messages from new users
>>> who have troubles getting started with Valentina? A product  
>>> without a
>>> detailed manual is useless. We have told you many times to improve
>>> the documentation. What has happened? Absolutely nothing. The wiki  
>>> is
>>> a mess. The language used is in very cases very terse. As a reader I
>>> also need to know why something needs to be done and not just "do  
>>> it".
>>>
>>> I love Valentina as a database, but documentation and ease of use  
>>> are
>>> not it's forte.
>>>
>>> And I still need to find out why the obnoxious VStudio doesn't want
>>> to start on the Leopard machine. This software is a pain to use
>>> because it crashes so often. And it feels very clumsy.
>>
>> -- 
>> Best regards,
>>
>> Ruslan Zasukhin
>> VP Engineering and New Technology
>> Paradigma Software, Inc
>>
>> Valentina - Joining Worlds of Information
>> http://www.paradigmasoft.com
>>
>> [I feel the need: the need for speed]
>>
>>
>> _______________________________________________
>> Valentina mailing list
>> Valentina at lists.macserve.net
>> http://lists.macserve.net/mailman/listinfo/valentina
>
> _______________________________________________
> Valentina mailing list
> Valentina at lists.macserve.net
> http://lists.macserve.net/mailman/listinfo/valentina
>