For discussing documentation, including fixes to docs, new documentation, or translations

Suggestions for the Embedded Objects manual

Dear Uwe,

Attached are 72 suggested changes for the Embedded Objects manual. I only have one additional question below.

The table "Units available in LyX" in Appendix A appears to be the same table as in Appendix D of the User Guide. Why not implement this table as an external file in both guides so that if the table ever changes, it is automatically updated in both guides? I'm guessing the reason for not doing this is that the table is unlikely to change. I wonder if there is other overlapping material across manuals that is likely to change.

Thank you!

Scott Kostyshak

Attachment (EmbeddedObjects.lyx): application/x-lyx, 682 KiB

headers

Uwe Stöhr | 12 Feb 04:13

Re: Suggestions for the Embedded Objects manual

Am 08.02.2012 06:32, schrieb Scott Kostyshak:

> Attached are 72 suggested changes for the Embedded Objects manual.

Many, many thanks!

95% of them are in and you also found some bugs that I now corrected in the other language versions.

If you are now still enthusiastic, I would be happy if you could also revise the Math manual. This 
is my oldest manual and therefore might have the most typos or inadequate expressions.

> I only have one additional question below.
>
> The table "Units available in LyX" in Appendix A appears to be the same table as in Appendix D of the User
Guide. Why not implement this table as an external file in both guides so that if the table ever changes, it
is automatically updated in both guides? I'm guessing the reason for not doing this is that the table is
unlikely to change. I wonder if there is other overlapping material across manuals that is likely to change.

Good idea, this is of course possible. But for now I won't add an additional file in our stable LyX 
series. I will do this for the next major release LyX 2.1.0.

best regards
Uwe

headers

Uwe Stöhr | 12 Feb 04:20

Re: Suggestions for the Embedded Objects manual

Am 12.02.2012 04:13, schrieb Uwe Stöhr:

> If you are now still enthusiastic, I would be happy if you could also revise the Math manual.

I forgot to say that you must use LyX's stable series (LyX 2.0.x) for revisions. For your 
EmbeddedObjects revision you used an unstable development version of the upcoming LyX 2.1.x. The 
documentation files of the stable and the development series are not the same and menus that might 
appear incorrect in the manuals that come with the development version are in reality correct in LyX 
2.0.x

regards Uwe

headers

Scott Kostyshak | 12 Feb 05:38

RE: Suggestions for the Embedded Objects manual

From: Uwe Stöhr [uwestoehr <at> web.de]
Sent: Saturday, February 11, 2012 10:20 PM

>I forgot to say that you must use LyX's stable series (LyX 2.0.x) for revisions. For your
>EmbeddedObjects revision you used an unstable development version of the upcoming LyX 2.1.x. The
>documentation files of the stable and the development series are not the same and menus that might
>appear incorrect in the manuals that come with the development version are in reality correct in LyX
>2.0.x

OK, thanks for letting me know. I will keep that in mind in the future.

From: Uwe Stöhr [uwestoehr <at> web.de]
Sent: Saturday, February 11, 2012 10:13 PM

>If you are now still enthusiastic, I would be happy if you could also revise the Math manual. This
>is my oldest manual and therefore might have the most typos or inadequate expressions.

Sure, I'll gladly take a look at it. I think it will take some time for me to go through it carefully. I'll get
back to you in a couple of months.

Thanks and regards,

Scott

headers

Uwe Stöhr | 12 Feb 16:03

Re: Suggestions for the Embedded Objects manual

Am 12.02.2012 05:38, schrieb Scott Kostyshak:

>> If you are now still enthusiastic, I would be happy if you could also revise the Math manual. This
>> is my oldest manual and therefore might have the most typos or inadequate expressions.
>
> Sure, I'll gladly take a look at it. I think it will take some time for me to go through it carefully. I'll get
back to you in a couple of months.

There is no timeline. You can do this whenever you want. The amount of text it much less then in the 
EmbeddedObjects manual so I guess it will take you less time for the revision.

best regards
Uwe