On Wed, Jan 12, 2005 at 05:20:49PM -0800, Jeremy C. Reed wrote:
> On Wed, 12 Jan 2005, John Weiss wrote:
> 
> > Use a separate doc and include it via a master doc.
> 
> I was thinking about that. Other than the book will have a lot of
> redundant information.

Yes, that is a problem, isn't it?

> > One of the primary design constraints of the LyX Docs is that it be
> > readable both in print and online.  It serves both of these purposes.
> 
> I understand.

:
:

> A master document including the parts is a good idea; maybe the individual
> parts can still be rewritten some so they don't repeat to much.

Alas, no.

The repetition was added, intentionally, after I was told that I had
the wrong balance.

See, I originally came up with a compromise:  just enough repetition
so that a user wouldn't need to go flipping to a different document
*most* of the time.  Keeping repetition to a minimum, referencing
other docs, was a maintenance strategy (less repetition ==> less
editing when repeated parts need to change).

However, the balance I came up with assumed that our users remember things
as well as I do ... or used to 7 years ago :P ... which wasn't
correct.  So others later added in more repetition.



Change the individual docs to reduce the repetition, and you'll soon
be hearing shrieks of pain from LyX users.  This is, yet again, one of
those compromises we made between "read online" and "read printed
version".

-- 
John Weiss

Reply via email to