On Wed, 25 Jul 2001, John Levon wrote:
> On Tue, Jul 24, 2001 at 03:11:06PM -0700, Mike Ressler wrote:
>
> > Philosophy: the Intro should be an intro: it is assumed to be chapter 1
> > for all other docs. Place less emphasis on doc team by changing that
> > section to an appendix.
>
> I would rather move all the stuff about contributing (other than reporting
> bugs) to DocStyle. This is often the first thing they read (it should be)
> and having this stuff here is just silly IMHO
Excellent suggestion - I had forgotten about DocStyle :-) However,
DocStyle is not typically installed, so I'd like to keep one line about it
somewhere in the normal docs. ("If you would like to contribute, please
see DocStyle.lyx in the .../lib/docs directory of the LyX tarball.")
> Also ditch the "DANGER DANGER" thing. It is NOT a good thing to have as the
> first page of an introduction. I'm not suggesting we hide the fact
> lyx is short on documenters (thought the docs that exist are on the whole
> very good), but we shouldn't shove it in their faces.
Agreed, I intend to rewrite much of the Intro ...
> > Keep the Tutorial lean and clean: teach, don't
> > preach.
>
> it rhymes, it must be true !
Comes from having 3 kids 6 yr and younger ...
> > can twiddle. Reference is no longer pertinent to the average user and
> > should thus be eliminated (but it should still exist for developer use).
>
> why is it not pertitent ? just because it's horrendously out of date ?
Horrendously out of date, and for a _typical_ user, not terribly helpful.
Do non-developers really care that there is a
"toggle-cursor-follows-scrollbar" function? Doubtful - they just want to
know there is an option in Edit->Preferences that allows the cursor to
follow the scrollbar (which should be in Customization). The
popup/interface chapter (2) might be more useful, but it is covered by the
UG, though granted, not in a blow-by-blow, down-the-list description.
If we decide to keep it, I would suggest throwing away everything but
Chapters 2 and 4 (popups and keybindings) - put everything else in a
developers reference file (and let them worry about it :-). My preference
would still be move keybindings to Customization and tossing everything
else.
>
> > 5.2.5 BibTeX
>
> is this really where bibtex is hidden ? I think it should be promoted
> a little more. You don't really need to know latex to use it...
It also appears as section 1.2 of Extended (Preparing a Bibliography with
BibTeX). In the Intro, I'd like to list a few of the spiffy capabilities
of LyX - this would be a Good Thing to mention there.
> > 1.3.2.2 Popups
>
> this would be an ideal time to standarise on this terminology. I think
> we discovered last little survey, that "dialog" was most definitely
> the better known term.
Totally agree. Lot of work, but I'll make it happen.
Mike
--
Mike Ressler
[EMAIL PROTECTED]
OK, I'm lame: I don't have my own website ...
