Pascal, Alex,

I agree that the help and the tutorial are more important.  In fact, I
think that once the tutorial is in place, there is no need to maintain
html help files.  They come with Scid and newbies don't need them :
they need a << Scid for the impatient >>.  What we would need is a
manual, but we're a long way from there.  That could be a wiki, if
that is not too cumbersome [^note].

There is no dillemma between rebuilding the site and creating the
tutorial.  A webpage is more than a bunch of linked pages : it's an
information architecture.  Before creating a link to a page, I must
make sure that : the page exists and that it satisfies the reason why
I am linking to it.

Besides, just look at the main page !  For starters, what is Scid
exactly, << a free chess database app >> ?  That must be, since the
expression is repeated three times.  Minimally, using an abbreviation
is not good.

So what exactly _is_ Scid ?  What are its main features ?  This is not
just marketing stuff.  This is important for the tutorial, the main
page, the fast intro, the Wikipedia entry, etc.  To use terms in a
consistent way, we must take care of them right at the beginning.  We
must decide what terms to describe the toolkit.

(I imagine that Scid is a toolkit, for now,  It could also be a
_suite_, but that sounds too much like corporate-talk.  What exactly
is Scid ?)

The time-frame I set myself included the tutorial, btw.  Scid's
website is at most ten pages deep : no terrifying depth there.  It's
not that deep that I should not work on the HTML templates first.
The actual HTML template does need repairs.  We don't create tables to
insert navigation anymore.

I wish you all a splendid day,

Benoit

***

[^note]   I have begun last  year to modify the tcl file of the help.
I did not finish all the pages, but did enough of them to understand
that a big tcl file for all the help sections is certainly no fun to
maintain.  One reason is that both porting the modification to the
HTML files on the website or creating a big html file around are not
trivial matters.  It would be interesting to include each section of
the help files to facilitate maintenance, like we do in LaTeX for
instance.  I will return to that in October, if all goes well.

-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Scid-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/scid-users

Reply via email to