Re: please consolidate the documentation

Helge Hafting wrote: On Fri, Jul 21, 2006 at 12:08:48AM +1000, John Pye wrote: I don't think that we should expect people to use LyX as their documentation browser. Sure, LyX is not my choice for a browser. But documentation for LyX itself is a special case, see below: Operating syst

Re: please consolidate the documentation

On Fri, Jul 21, 2006 at 12:08:48AM +1000, John Pye wrote: > Hi all, > > I'd like to say congratulations to all on the re-inauguration of the LyX > documentation team ;-) ! The scattered documentation of LyX has > frustrated me too. I have some thoughts and ideas to mention... > [...] > I don't thi

Re: please consolidate the documentation

John Pye wrote: Hi all, I'd like to say congratulations to all on the re-inauguration of the LyX documentation team ;-) ! The scattered documentation of LyX has frustrated me too. I have some thoughts and ideas to mention... First, I think that the shining example of the *delivery* of software

Re: please consolidate the documentation

Jean-Pierre Chretien wrote: Date: Thu, 20 Jul 2006 03:05:50 -0700 To: Jean-Pierre Chretien <[EMAIL PROTECTED]> CC: lyx-users@lists.lyx.org Subject: Re: please consolidate the documentation From: Stephen Harris <[EMAIL PROTECTED]> [...] swish-e is supposed to be capable of ind

Re: please consolidate the documentation

we're very interested in taking the right approach here. I'm sure a lot of other writers, especially of software documentation, must be as well. Cheers JP Jean-Pierre Chretien wrote: >>>Date: Thu, 20 Jul 2006 03:05:50 -0700 >>>To: Jean-Pierre Chretien <[EMAIL

Re: please consolidate the documentation

>>Date: Thu, 20 Jul 2006 03:05:50 -0700 >>To: Jean-Pierre Chretien <[EMAIL PROTECTED]> >>CC: lyx-users@lists.lyx.org >>Subject: Re: please consolidate the documentation >>From: Stephen Harris <[EMAIL PROTECTED]> [...] >> >>swish-e is sup

Re: please consolidate the documentation

Jean-Pierre Chretien wrote: Date: Wed, 19 Jul 2006 09:37:55 -0700 To: lyx-users@lists.lyx.org Subject: Re: please consolidate the documentation From: Stephen Harris <[EMAIL PROTECTED]> Ingo Klöcker wrote: Am Mittwoch, 19. Juli 2006 08:58 schrieb Martin A. Hansen: [...] In any case, I&#x

Re: please consolidate the documentation

>>Date: Wed, 19 Jul 2006 09:37:55 -0700 >>To: lyx-users@lists.lyx.org >>Subject: Re: please consolidate the documentation >>From: Stephen Harris <[EMAIL PROTECTED]> >> >>Ingo Klöcker wrote: >>> Am Mittwoch, 19. Juli 2006 08:58 schrieb Martin A

Re: please consolidate the documentation

Ingo Klöcker wrote: Am Mittwoch, 19. Juli 2006 08:58 schrieb Martin A. Hansen: So what is the typical use-case for the LyX Manual? That someone wants to read it from the first page to the last page? Or that someone wants to read about a specific subject, say including graphics? In my experi

Re: please consolidate the documentation

Am Mittwoch, 19. Juli 2006 08:58 schrieb Martin A. Hansen: > once again -> pdf files are for printing and reading - not for > reading online. printing the documentation may give you a nice book > to keep under the pillow, but it prevents you from seeing how lyx > formatting is done, using cross ref

Re: please consolidate the documentation

once again -> pdf files are for printing and reading - not for reading online. printing the documentation may give you a nice book to keep under the pillow, but it prevents you from seeing how lyx formatting is done, using cross refereces etc. and i think that lyx is an extremely nice "editor" to

Re: please consolidate the documentation

Sven Schreiber schrieb: Well isn't there a documentation team? Unfortunately there is no team. At the moment the developers add new docs sections if they implemented a new feature. Therefore the docs aren't consistent in style and not always well verbalized. The last time I cleaned up the do

Re: please consolidate the documentation

Daniel Watkins ha scritto: > Sven Schreiber wrote: >>> So please consolidate the documentation into one file (or let me do it). > > I promise you, no-one here is going to hold you back, if you're > volunteering[*]. :p There is a problem you may have missed: in some languages (italian at least) on

Re: please consolidate the documentation

[EMAIL PROTECTED] schrieb: > On Tue, 18 Jul 2006, Sven Schreiber wrote: > >> Yes, easily getting an overview of what's in the help file. > > Good point. To summarize: > > * We'd like an overview of what's in all the help files. Perhaps some > kind of table of contents for the whole thing. > >

Re: please consolidate the documentation

>>To: lyx-users@lists.lyx.org >>From: [EMAIL PROTECTED] >>Subject: Re: please consolidate the documentation >>Date: Tue, 18 Jul 2006 15:24:33 +0200 >>X-X-Sender: [EMAIL PROTECTED] >> >>On Tue, 18 Jul 2006, Sven Schreiber wrote: >> >>> Y

Re: please consolidate the documentation

On Tue, 18 Jul 2006, Sven Schreiber wrote: Yes, easily getting an overview of what's in the help file. Good point. To summarize: * We'd like an overview of what's in all the help files. Perhaps some kind of table of contents for the whole thing. * We'd like to be able to search all the hel

Re: please consolidate the documentation

On Tue, 18 Jul 2006, Angus Leeming wrote: No, you're right. The last editor was Mike Ressler and the last time that he was actively involved was in the middle of 2002... Just out curiosity, who were editors before him? (I thought I'd write it down here) http://wiki.lyx.org/devel/pmwi

Re: please consolidate the documentation

On Mon, 17 Jul 2006, Steve Harris wrote: [EMAIL PROTECTED] wrote: Having said that, I think there at least used to be a pretty good reason for why the documentation was split the way it is. So I suggest you raise this question on the development list. best regards /Christian I think the

Re: please consolidate the documentation

On Mon, 17 Jul 2006, Steve Harris wrote: Well, I made the Wiki Entry under Manuals, but the Wiki complained the file was too large to accept = almost 4mb Ok. (It might also fit under http://wiki.lyx.org/LyX/Documentation ) As for the file, could you try using YouSendIt to send it to me? (See

Re: please consolidate the documentation

<[EMAIL PROTECTED]> writes: > Having said that, I think that what the LyX documentation mainly needs is > an editor - someone to guide/decide what should go into the documentation. > As far as I know there is no editor today (please correct me if I'm > wrong!) No, you're right. The last editor

Re: please consolidate the documentation

[EMAIL PROTECTED] schrieb: > > As for the problem of searching all the help documentation, couldn't we > ask the developers for a special help menu entry that says something like: > > Search help documents > > This seems to me like it would solve the problems you are talking about. > Are th

Re: please consolidate the documentation

On Tue, 18 Jul 2006, Martin A. Hansen wrote: I sincerely feel that the tutorial should also be included in a single documentation file consisting of UG, extended etc. the reason for this is that you can then cross-link from the tutorial to the parts of the UG explaining a feature in depth. als

Re: please consolidate the documentation

On Tue, 18 Jul 2006, Martin A. Hansen wrote: and yes - the documentation should be a lyx document so you see for yourself how the lyx formatting is actually done - with the help of notes and cross-references. Agreed while the lyx documentation should contain all the relevant documentation t

Re: please consolidate the documentation

On Tue, 18 Jul 2006, Sven Schreiber wrote: For people interested in helping with the documentation, please read the links at the bottom of this page: http://wiki.lyx.org/LyX/Documentation#toc5 Especially look at this page http://wiki.lyx.org/devel/pmwiki.php/Devel/MiscNotes

Re: please consolidate the documentation

On Tue, 18 Jul 2006, Sven Schreiber wrote: Helge Hafting schrieb: On Mon, Jul 17, 2006 at 01:06:05PM +0200, Sven Schreiber wrote: If you do a lot of searching, consider making a document consisting of User's guide + extended features in one document. Just paste one into the other, perhaps

Re: please consolidate the documentation

nice plan sven! crisp and simple :o) and yes - the documentation should be a lyx document so you see for yourself how the lyx formatting is actually done - with the help of notes and cross-references. i myself would always read the documentation in lyx and not as pdf or dvi - i only use those to

Re: please consolidate the documentation

Helge Hafting schrieb: > On Mon, Jul 17, 2006 at 01:06:05PM +0200, Sven Schreiber wrote: > > If you do a lot of searching, consider making a document > consisting of User's guide + extended features in one > document. Just paste one into the other, > perhaps as part I and part II. Pe

Re: please consolidate the documentation

I sincerely feel that the tutorial should also be included in a single documentation file consisting of UG, extended etc. the reason for this is that you can then cross-link from the tutorial to the parts of the UG explaining a feature in depth. also, you can search the entire document for whateve

Re: please consolidate the documentation

[EMAIL PROTECTED] wrote: Having said that, I think there at least used to be a pretty good reason for why the documentation was split the way it is. So I suggest you raise this question on the development list. best regards /Christian I think the end of the splash.lyx intro screen could be

Re: please consolidate the documentation

Ed Gatzke wrote: Change the "titles" to "Parts" and copy paste the rest in. Use Insert->Insert File->LyX file. Rich I think you miss out on some formatting, and you may have trouble with multiple titles/authors and different preambles. To make one super document, the title of the indi

Re: please consolidate the documentation

Ed Gatzke wrote: Change the "titles" to "Parts" and copy paste the rest in. Use Insert->Insert File->LyX file. Rich I think you miss out on some formatting, and you may have trouble with multiple titles/authors and different preambles. To make one super document, the title of the indi

Re: please consolidate the documentation

> > Change the "titles" to "Parts" and copy paste the rest in. > >Use Insert->Insert File->LyX file. > > Rich I think you miss out on some formatting, and you may have trouble with multiple titles/authors and different preambles. To make one super document, the title of the individual fi

Re: please consolidate the documentation

On Mon, Jul 17, 2006 at 01:06:05PM +0200, Sven Schreiber wrote: > Dear lyxers, > > don't know if this is the right list, but anyway: I have tried many > times to understand the logic behind the various help documents > (tutorial, user guide, extended features, ... and this list goes The logic is

Re: please consolidate the documentation

On Mon, 17 Jul 2006, Daniel Watkins wrote: I think there is one. At least they have a mailing list. Try sending a mail to their mailing list at lyx-docs@lists.lyx.org That has nothing but automatically sent 'Wiki changes' updates. I unsubscribed a while ago, so it may ahve changed since. T

Re: please consolidate the documentation

On Mon, 17 Jul 2006, Ed Gatzke wrote: Change the "titles" to "Parts" and copy paste the rest in. Use Insert->Insert File->LyX file. Rich -- Richard B. Shepard, Ph.D. |The Environmental Permitting Applied Ecosystem Services, Inc.(TM)|Accelerator

Re: please consolidate the documentation

> agreed! > > one file would be so nice, because then you could search for a particular > keyword you are looking for without having to open all the different help > files. and since lyx/latex is so good at sectioning, it would be straight > forward to combine them all. > It does not take much

Re: please consolidate the documentation

-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Andreas K. wrote: > I think there is one. At least they have a mailing list. Try sending a > mail to their mailing list at > lyx-docs@lists.lyx.org That has nothing but automatically sent 'Wiki changes' updates. I unsubscribed a while ago, so it may a

Re: please consolidate the documentation

Sven Schreiber <[EMAIL PROTECTED]> writes: > Well isn't there a documentation team? I think there is one. At least they have a mailing list. Try sending a mail to their mailing list at lyx-docs@lists.lyx.org Andreas

Re: please consolidate the documentation

Sven Schreiber wrote: > Well isn't there a documentation team? AFAIK, you just became it. > What would be the recommended way of making a concrete proposal, attach > the resulting single lyx file to a message on this list? As this would be around 1.5MB (assuming that you just stuck all of the doc

Re: please consolidate the documentation

Daniel Watkins schrieb: > Sven Schreiber wrote: >>> So please consolidate the documentation into one file (or let me do it). > > I promise you, no-one here is going to hold you back, if you're > volunteering[*]. :p > Well isn't there a documentation team? Maybe they don't think it's a good idea?

Re: please consolidate the documentation

On 7/17/06, Martin A. Hansen <[EMAIL PROTECTED]> wrote: agreed! one file would be so nice, because then you could search for a particular keyword you are looking for without having to open all the different help files. and since lyx/latex is so good at sectioning, it would be straight forward to

Re: please consolidate the documentation

-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Sven Schreiber wrote: > So please consolidate the documentation into one file (or let me do it). I promise you, no-one here is going to hold you back, if you're volunteering[*]. :p Dan [Footnote *: Unless, of course, you submit multi-change patche

Re: please consolidate the documentation

agreed! one file would be so nice, because then you could search for a particular keyword you are looking for without having to open all the different help files. and since lyx/latex is so good at sectioning, it would be straight forward to combine them all. martin On 7/17/06, Sven Schreiber