Benoit St-Pierre wrote:
Hi!
> I fear that it will be hard to separate automagically description of a
> functionality with everything else.
Automatically, yes. But I think if there is a section where
the help itself is target of the work, I fancy most users
will get it right where to add text.
>> Besides: there are some projects that do not have any F1
>> help locally, but always link to a certain wiki page online.
>> I'm not sure that I like this, but one could think in this
>> direction.
>
> Yes, that is a possibility. We would have to consider it if we can't
> improve the help.tcl file. I would like to give it another chance,
> though. In any case, we need to improve what we have now as a
> help.tcl file. And you know I am starting to work on it.
Up to you. I'll not interfere here, however I'll try to help
out in case of questions, as far as I can answer them.
>> The only point I'd not have like wikipedia is this senseless
>> discussions going on there about relevance of an article.
>> IMHO if someone took the time to write an article it made
>> sense for him to have it and one is done with this
>> discussion. Doesn't eat any bread in the database.
>
> Agreed. In fact, since we have a mailing list, we do not even have
> to discuss anything in the wiki itself.
I came to some conclusion that Wikis does not work well for
real discussion.
> (Besides, if we have a flat file system, we do not even
> have that database problem ;-)
Databases are never a problem, only a solution ;)
>> I'm not sure that the online help should not contain such
>> things. IMHO the most helpful docs always contain real world
>> examples: not trivial but also not absolutely unearthy to
>> show all features by construction.
>
> The problem is that there is one F1 file and many Scid
> versions, with all their own idiosyncrasies.
Help concerns with the current version only.
> I just got this idea : we can have a type for the F1 help topics, e.g.
> Nutshell or Description. It can be a page title, a section title, a
> category, etc.
>
> So we may be able to have both the cake and eat it ;-)
Go on :)
--
Kind regards, / War is Peace.
| Freedom is Slavery.
Alexander Wagner | Ignorance is Strength.
|
| Theory : G. Orwell, "1984"
/ In practice: USA, since 2001
------------------------------------------------------------------------------
Apps built with the Adobe(R) Flex(R) framework and Flex Builder(TM) are
powering Web 2.0 with engaging, cross-platform capabilities. Quickly and
easily build your RIAs with Flex Builder, the Eclipse(TM)based development
software that enables intelligent coding and step-through debugging.
Download the free 60 day trial. http://p.sf.net/sfu/www-adobe-com
_______________________________________________
Scid-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/scid-users
