Mark comments about wiki

[Mark Schonewille]

Hi Ruslan,

As I wrote earlier, when install software, I expect to find all 
essential information in the application folder and not on the website. 
Surely, you can continue to argue that all information is somewhere on 
the internet, but I really don't know where to start looking on the 
Valentina website. Even worse: I was seriously doubting that I was 
looking at the correct website.

Therefore, I recommend to include a PDF with the software that is 
installed on the user's computer. The user reads the PDF, say 25 pages, 
and will know everything s/he needs to start using the software and to 
find more information in other places. For example, you could write a 
section about how to find our way in the WIKI, which really isn't 
obvious to me. Apparently, there are sections for each product, but 
sometimes you need to look in a different section. WIKIs are a bad way 
to provide new users with documentation and I would prefer a simple PDF.

So, the point is not that the information is not there. The point is 
that I find it difficult for me to find the information I need. I'll 
have a closer look at your reply later tonight. I'm sure your answers 
will be useful.

--
Best regards,

Mark Schonewille

Economy-x-Talk Consulting and Software Engineering
Homepage: http://economy-x-talk.com
Twitter: http://twitter.com/xtalkprogrammer
KvK: 50277553

Use Color Converter to convert CMYK, RGB, RAL, XYZ, H.Lab and other 
colour spaces. http://www.color-converter.com

Buy my new book "Programming LiveCode for the Real Beginner" 
http://qery.us/3fi

Fill out this survey please
http://livecodebeginner.economy-x-talk.com/survey/

On 10/6/2013 13:19, Ruslan Zasukhin wrote:
> On 10/6/13 12:38 PM, "Mark Schonewille" <m.schonewille at economy-x-talk.com>
> wrote:
>
> Hi Mark,
>
>> The wiki seems very old to me.
>
> Step by step.
>
> I am opening wiki ... And follow to your questions:
>
>
>> It is often obsolete and it doesn't tell
>> me the basics I need to know, such as
>
>
>> "there is a SQL editor in  Valentina Studio",
>
> Hmmm,
>
> 1)
>
> I think this is mentioned right on SITE page about Valentina Studio.
> FIRST page which visitor read about Valentina Studio is:
>
>          http://www.valentina-db.com/valentina-studio-overview
>
> Scroll down and ...
>
> ======================
> SQL Editor
>
> Write SQL queries fast using auto-completion, color syntax
> Define and manage favorite queries
> Recent queries
> ======================
>
>
> 2) now lets look in Valentina WIKI
>     FIRST PAGE   <http://www.valentina-db.com/docs/dokuwiki/v5/doku.php>
>
> I put my eyes into left TOC.
>
>          Articles
>          Valentina FAQ
>          Valentina Features  -- Aha,  this can be interesting to learn
>
> Click to Features,   Choose Valentina Studio
>
> <http://www.valentina-db.com/docs/dokuwiki/v5/doku.php?id=valentina:features
> :vstudio:vstudio>
>
> All is described here... Yes Mark?
>
>
> 3) Another way ... Again from the top page of WIKI:
>            <http://www.valentina-db.com/docs/dokuwiki/v5/doku.php>
>
> I again put my eyes to left TOC
>
>      Valentina Products
>              Valentina Studio Documentation   -- choose it
>
> On next page:
>          Valentina Studio Help
>
> We come to BIG and DETAILED section about Valentina Studio:
>
>
> <http://www.valentina-db.com/docs/dokuwiki/v5/doku.php?id=valentina:products
> :vstudio:help:help>
>
>
>
>> "there are many ways to find the server version" and
>
> There was no such exactly answer.
> But that info I have give you still can be found in
>    Valentina Studio HELP
>    Valentina SQL Grammar and commands.
>
>
>> "why and how to register a new database".
>
> Okay, so this is about Valentina Server, yes?
> Can this be a FAQ ?
>
> When I learn some new product for me, I always jump to its FAQ first of all,
> Because usually here found main problems people meet.
>
> So lets go again to FRSIT PAGE of Valentina WIKI
>      <http://www.valentina-db.com/docs/dokuwiki/v5/doku.php>
>
> In the left TOC I select
>      Valentina FAQs
>
> Then
>      Valentina Server FAQs
>
> And I come to this page in TWO clicks
>
> <http://www.valentina-db.com/docs/dokuwiki/v5/doku.php?id=valentina:faqs:vsr
> v>
>
> On this page in section "Databases" you can see answer on your question.
>
>
>
>> The wiki often mentions
>> "Revolution" instead of "LiveCode".
>
> Yes,
>      REALBasic was renamed to Xojo
>      Revolution to LiveCode ...
>
> Unfortunately for us is hard do find/replace of this words in all places,
> But yes we should do this step ....
>
>