Mark comments about wiki

Ruslan Zasukhin ruslan_zasukhin at valentina-db.com
Sun Oct 6 15:02:13 CDT 2013


On 10/6/13 10:17 PM, "Mark Schonewille" <m.schonewille at economy-x-talk.com>
wrote:

Hi Mark,

> 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.

Okay, I see your points, but Mark,

    * Did you even install mySQL or postgreSQL ?
    * Did you ever install PHP?

Where they keep docs?  They keep docs on site, Online.
Installer have ReadMe. Nothing more.

And nobody complains on this.


25 page PDFs or 3 page PDF do not matters.
It will not be bale explain all.

For example INI file, which William thinks is important for beginners, but
it is not important, because it can work with default settings.

So I think, single URL to Valentina WIKI must be more than enough ...
But what I agree, we need on site add more direct links into Valentina Wiki
parts.  
  Vserver page           ->  vserver docs
  Livecode page         -> LiveCode docs in Valentina Wiki


> 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.

But if you look around, software industry very actively use online docs.
MySQL, SQLite, postgreSQL, PHP, ....
Right?

Problem is that we do not have easy way convert WIKI to PDF.

And it is absolute hell try to copy paste WIKI and yet PDF sources.
Will be more mess only

Wiki allows to add-fix information in minutes. Just online.
So we choose WIKI.
 

> 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.

Yes, this is problem, and I hope you see, that last few days we very
actively discuss this ... Thank you very much.

    PLEASE DON'T GIVE UP! :-)
    PRESS US, 
    KICK US 

Even if I argue, In this answers I explain PATH ... And
Sometimes I see where are problems on that path,

New videos is our first reaction to simplify things for new-comers.
One accurate video in 8-10 minutes, takes one day of job for me.

But I hope this will be very useful :-)

I already have integrate 3 videos into Valentina WIKI sections.
Into section videos, and also into sections of

VSERVER
Vstudio
Xojo 


And I am going spend yet weak at least,
improving things for BEGINERS.


-- 
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]




More information about the Valentina mailing list