On Mon, 24 Jan 2005, John Weiss wrote:
> On Thu, Jan 20, 2005 at 03:50:51PM +0100, [EMAIL PROTECTED] wrote:
> > On Thu, 20 Jan 2005, Jean-Marc Lasgouttes wrote:
> > * How would users like to read the FAQ?
> > ** Users want to read/browse the FAQ as web (wiki) pages.
> > This requires an internet connection unless we package a local copy of
> > the web (wiki) pages with the LyX documentation.
> > ** Users want to read their FAQ.lyx that comes installed with LyX
>
> Honestly, I don't think we really need to have the FAQ be a LyX
> document anymore. HTML pages, possibly generated from the Wiki,
> should be sufficient. (It's not like web browsers are all that rare
> anymore.)
I agree, what was your opinion Jean-Marc?
As for where to keep the "source" of various documents, here is the
current situation AFAIK:
Document Source is kept in <x> as <y> Comment
Introduction LyX inst, Intro.lyx
Tutorial LyX inst, Tutorial.lyx
User guide LyX inst, UserGuide.lyx Serves as user example
Custom. LyX inst, Customize.lyx
Extended fea. LyX inst, Extended.lyx
FAQ Wiki => HTML with LyX inst
Reference doc LyX inst, Reference.lyx
As per John's thinking, I've listed an alternative suggestion of where/how
to keep the source of the documentation.
Document Source is kept in <x> as <y> Comment
Introduction LyX inst, Intro.lyx [1][2][3]
Tutorial LyX inst, Tutorial.lyx [1][2][3]
User guide LyX inst, UserGuide.lyx [1][2][3]
Custom. Wiki => HTML incl w LyX [4]
Reference Wiki => HTML incl w LyX [4]
FAQ Wiki => HTML incl w LyX [4]
Extended fea. LyX inst, Extended.lyx
DocStyle LyX inst, DocStyle.lyx [1]
[1] - Under tight editorial control.
[2] - The (LyX) document also servers as an example of
'how-to-do-that' using LyX
[3] - There are wiki pages for submitting minor corrections/addendums
[4] - Primarily maintained by LyX community, need some editors though
Does this sound good/bad?
What documentation have I forgotten here?
I should probably mention a few things regarding the wiki:
* We can protect pages/groups using passwords if needed
* We can (easily) design our own wiki markup for special needs
/Christian
--
Christian Ridderström, +46-8-768 39 44 http://www.md.kth.se/~chr
