Hi Everybody,
Probably I'm joining this discussion a bit late, and since I'm not
writing any documentation myself you can take my opinion for what
it's worth, but ...
Is LyX really a good platform for writing a large technical document?
The latex output which it produces is not of the best quality, and
might end up becoming difficult to maintain. Latex itself is not
very difficult to write by hand, and that would give you much
more control over the formatting, eg. making it easier to define
consistent macros for notation, cross-referencing, etc.
It's possible that LyX has come a long way since I last looked at it
seriously, but I'm skeptical. In fact, just now I installed a new copy
and could not correctly re-import a tex file that I exported from LyX
itself ...
The document linked earlier in this thread looks fine, I'm just
concerned about what the underlying latex looks like.
I suspect taking the time to learn writing latex directly (again: it's
easy, I work in a building full of computer semi-literates and we all
use it to write scientific papers, books, and technical documentation)
would very quickly pay off over the first-glance benefit of a wysiwyg
editor.
In any case, it's good to see someone working on this so keep it up,
Denis.
On Wed, 2001-10-17 at 09:28, Tuukka Toivonen wrote:
> On Wed, 17 Oct 2001, Oscar Lopez wrote:
>
> >I use lyx and everyone agrees in the excellent documentation that
> >accompanies this nice piece of software. They have structured the help
> >documentation in several documents. A maxima replicant outline could be:
>
> Yes, and when I'm looking for something, I may have to look from all *three*
> manuals which is very cumbersome. I would rather prefer just one longer
> manual. And besides, the LyX documentation is *very* long. Before the
> Maxima documentation gets to the same length, I don't think we should
> even talk about splitting it into multiple documents.
> Of course, this is just my personal opinion...
>
> --
> | Tuukka Toivonen <tuukkat@ee.oulu.fi> [PGP public key
> | Homepage: http://www.ee.oulu.fi/~tuukkat/ available]
> | Try also finger -l tuukkat@ee.oulu.fi
> | Studying information engineering at the University of Oulu
> +-----------------------------------------------------------
>
> _______________________________________________
> Maxima mailing list
> Maxima@www.math.utexas.edu
> http://www.math.utexas.edu/mailman/listinfo/maxima
>
--
----------------------------------------------------------------------
Denis Pollney <pollney@aei.mpg.de>
Max-Planck-Institut fuer Gravitationsphysik +49-331-567-7367
Albert Einstein Institut, Am MuehlenBerg 5, D-14476, Golm, Germany