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. also, you can search the entire document
for whatever and find it both in the tutorial context (with links to the
UG context) and the UG context.
Is cross-linking and being able to search the only reason you wish to have
these documents merged?
Please don't forget that we can ask the developers for a way to cross-link
to *other* documents, as well as for a special mechanism that lets you
search all the help documents.
Steven has also created a (I think) merged PDF containing all the
information, so at least searching all of the documentation within a
single file can be solved. (Albeit not from within LyX).
I'm not absolutely against a reduction of the number of documents, but I
do think we should be careful. Please read the links I sent in another
post. I definitely think there are valid reasons for keeping these
documents separate.
We should also be careful about what the problem is that we are really
trying to solve. If it is a matter of cross-linking, why not ask for a
method that let's us cross-link between different documents? That is
something that would have been useful for me when writing my (multi-part)
thesis for instance. I'm sure it would be useful in other situations as
well.
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 there any other reasons for merging the documents?
sincere regards
/Christian
--
Christian Ridderström, +46-8-768 39 44 http://www.md.kth.se/~chr
