Re: Suggestions for the Additional Features manual

[Richard Heck]

On 05/13/2012 10:32 PM, Scott Kostyshak wrote:

*From:* Richard Heck [rgh...@comcast.net]
*Sent:* Thursday, February 16, 2012 5:46 AM

I think that Chapter 6 should be last, either as a chapter or as an 
appendix. I would prefer as an appendix because I think that the main 
document should be something that would be of general interest to many 
people, whereas an appendix could be more for specific cases that are 
there for reference purposes. Chapter 6 interrupts the flow, in my 
opinion. As soon as I read the first sentence of the chapter, This 
section describes how LyX can be used to write articles for submission 
to the scientific journal Astronomy and Astrophysics... I figured 
that all of the general stuff was over. But in fact Chapters 7 and 8 
seem much more general than the current Chapter 6.


This seems like a good idea. I suspect many of the sections in 
Chapter 6 are probably quite out of date, as well. The bit on 
koma-script, for example, seems to date to something like 2005.


Should I make this change and send it to you? For branch or trunk or both?


Both. Feel free to do it a bit at a time.

Richard

Re: Suggestions for the Additional Features manual

[Mike Ressler]

Meant to send this to the whole list, not just Richard.


-- Forwarded message --
From: Mike Ressler mike.ress...@alum.mit.edu
Date: Mon, May 14, 2012 at 1:22 PM
Subject: Re: Suggestions for the Additional Features manual
To: rgh...@comcast.net


Hi,

On Mon, May 14, 2012 at 5:25 AM, Richard Heck rgh...@comcast.net wrote:
 On 05/13/2012 10:32 PM, Scott Kostyshak wrote:
 From: Richard Heck [rgh...@comcast.net]
I think that Chapter 6 should be last, either as a chapter or as an
 appendix.

Chapter 6 was put where it is because the document classes required
that the user download additional files, in the same way that Chapter
7 required the download of additional software. It was not an
arbitrary decision at the time. Chapter 8 originally had many weird
TeX/LaTeX tricks, but many have since been incorporated into LyX
itself, or have been move to other documentation.


 Chapter 6 interrupts the flow, in my opinion. As
 soon as I read the first sentence of the chapter, This section describes
 how LyX can be used to write articles for submission to the scientific
 journal Astronomy and Astrophysics... I figured that all of the general
 stuff was over. But in fact Chapters 7 and 8 seem much more general than the
 current Chapter 6.

I disagree, but that's because I helped write it :-)

This seems like a good idea. I suspect many of the sections in Chapter 6
 are probably quite out of date, as well. The bit on koma-script, for
 example, seems to date to something like 2005.

Don't assume this - AASTeX for example, whose section I did write, has
changed little in last 10 years, yet it is still the standard
submission package for the US astronomical journals. All the LyX
instructions still apply. I can't speak for the other sections, but
please check before altering things.

Mike

--
mike.ress...@alum.mit.edu


-- 
mike.ress...@alum.mit.edu

Re: Suggestions for the Additional Features manual

[Mike Ressler]

On Mon, May 14, 2012 at 10:04 PM, Scott Kostyshak
skost...@princeton.edu wrote:
 ok, I don't have a strong opinion on this. Shifting a chapter around should 
 only be done if it would unambiguously provide a significant benefit, which 
 it seems is not the case here. So I'll leave it alone.

Things do change over time, so if there is reason to reorder things
due to the evolution of LyX, feel free to do so. I'm thrilled that
there is interest in updating these docs. I just wanted to be clear
that there was a reason at the time for doing it the way we did. I
think it's important to keep the information in that chapter, but if
it is more sensible to move it elsewhere, don't hesitate.

Maybe this will get me motivated to fix the shaped paragraph section
since the page formatting changed since I wrote the original ...

Cheers.

Mike

-- 
mike.ress...@alum.mit.edu

Re: Suggestions for the Additional Features manual

[Richard Heck]

On 05/13/2012 10:32 PM, Scott Kostyshak wrote:

*From:* Richard Heck [rgh...@comcast.net]
*Sent:* Thursday, February 16, 2012 5:46 AM

>>I think that Chapter 6 should be last, either as a chapter or as an 
appendix. I would prefer as an appendix because I think that the main 
document should be something that would be of general interest to many 
people, whereas an appendix could be more for specific cases that are 
there for reference purposes. Chapter 6 interrupts the flow, in my 
opinion. As soon as I read the first sentence of the chapter, "This 
section describes how LyX can be used to write articles for submission 
to the scientific journal Astronomy and Astrophysics..." I figured 
that all of the general stuff was over. But in fact Chapters 7 and 8 
seem much more general than the current Chapter 6.


>This seems like a good idea. I suspect many of the sections in 
Chapter 6 are probably quite out of date, as well. The bit on 
koma-script, for example, seems to date to something like 2005.


Should I make this change and send it to you? For branch or trunk or both?


Both. Feel free to do it a bit at a time.

Richard

Re: Suggestions for the Additional Features manual

[Mike Ressler]

Meant to send this to the whole list, not just Richard.


-- Forwarded message --
From: Mike Ressler <mike.ress...@alum.mit.edu>
Date: Mon, May 14, 2012 at 1:22 PM
Subject: Re: Suggestions for the Additional Features manual
To: rgh...@comcast.net


Hi,

On Mon, May 14, 2012 at 5:25 AM, Richard Heck <rgh...@comcast.net> wrote:
> On 05/13/2012 10:32 PM, Scott Kostyshak wrote:
> From: Richard Heck [rgh...@comcast.net]
>>>I think that Chapter 6 should be last, either as a chapter or as an
>>> appendix.

Chapter 6 was put where it is because the document classes required
that the user download additional files, in the same way that Chapter
7 required the download of additional software. It was not an
arbitrary decision at the time. Chapter 8 originally had many weird
TeX/LaTeX tricks, but many have since been incorporated into LyX
itself, or have been move to other documentation.


>>> Chapter 6 interrupts the flow, in my opinion. As
>>> soon as I read the first sentence of the chapter, "This section describes
>>> how LyX can be used to write articles for submission to the scientific
>>> journal Astronomy and Astrophysics..." I figured that all of the general
>>> stuff was over. But in fact Chapters 7 and 8 seem much more general than the
>>> current Chapter 6.

I disagree, but that's because I helped write it :-)

>>This seems like a good idea. I suspect many of the sections in Chapter 6
>> are probably quite out of date, as well. The bit on koma-script, for
>> example, seems to date to something like 2005.

Don't assume this - AASTeX for example, whose section I did write, has
changed little in last 10 years, yet it is still the standard
submission package for the US astronomical journals. All the LyX
instructions still apply. I can't speak for the other sections, but
please check before altering things.

Mike

--
mike.ress...@alum.mit.edu


-- 
mike.ress...@alum.mit.edu

Re: Suggestions for the Additional Features manual

[Mike Ressler]

On Mon, May 14, 2012 at 10:04 PM, Scott Kostyshak
 wrote:
> ok, I don't have a strong opinion on this. Shifting a chapter around should 
> only be done if it would unambiguously provide a significant benefit, which 
> it seems is not the case here. So I'll leave it alone.

Things do change over time, so if there is reason to reorder things
due to the evolution of LyX, feel free to do so. I'm thrilled that
there is interest in updating these docs. I just wanted to be clear
that there was a reason at the time for doing it the way we did. I
think it's important to keep the information in that chapter, but if
it is more sensible to move it elsewhere, don't hesitate.

Maybe this will get me motivated to fix the shaped paragraph section
since the page formatting changed since I wrote the original ...

Cheers.

Mike

-- 
mike.ress...@alum.mit.edu

RE: Suggestions for the Additional Features manual

[Scott Kostyshak]

From: Richard Heck [rgh...@comcast.net]
Sent: Thursday, February 16, 2012 5:46 AM

I think that Chapter 6 should be last, either as a chapter or as an appendix. 
I would prefer as an appendix because I think that the main document should 
be something that would be of general interest to many people, whereas an 
appendix could be more for specific cases that are there for reference 
purposes. Chapter 6 interrupts the flow, in my opinion. As soon as I read the 
first sentence of the chapter, This section describes how LyX can be used to 
write articles for submission to the scientific journal Astronomy and 
Astrophysics... I figured that all of the general stuff was over. But in 
fact Chapters 7 and 8 seem much more general than the current Chapter 6.

This seems like a good idea. I suspect many of the sections in Chapter 6 are 
probably quite out of date, as well. The bit on koma-script, for example, 
seems to date to something like 2005.

Should I make this change and send it to you? For branch or trunk or both?

Scott

RE: Suggestions for the Additional Features manual

[Scott Kostyshak]

From: Richard Heck [rgh...@comcast.net]
Sent: Thursday, February 16, 2012 5:46 AM

>>I think that Chapter 6 should be last, either as a chapter or as an appendix. 
>>I would prefer as an appendix because I think that the main document should 
>>be something that would be of general interest to many people, whereas an 
>>appendix could be more for specific cases that are there for reference 
>>purposes. Chapter 6 interrupts the flow, in my opinion. As soon as I read the 
>>first sentence of the chapter, "This section describes how LyX can be used to 
>>write articles for submission to the scientific journal Astronomy and 
>>Astrophysics..." I figured that all of the general stuff was over. But in 
>>fact Chapters 7 and 8 seem much more general than the current Chapter 6.

>This seems like a good idea. I suspect many of the sections in Chapter 6 are 
>probably quite out of date, as well. The bit on koma-script, for example, 
>seems to date to something like 2005.

Should I make this change and send it to you? For branch or trunk or both?

Scott

Re: Suggestions for the Additional Features manual

[Richard Heck]

On 01/20/2012 01:02 PM, Scott Kostyshak wrote:

Dear Richard,

Attached are 78 proposed changes for the Additional Features manual. A 
couple of additional issues --



I accepted those changes and committed the new version.

I think that Chapter 6 should be last, either as a chapter or as an 
appendix. I would prefer as an appendix because I think that the main 
document should be something that would be of general interest to many 
people, whereas an appendix could be more for specific cases that are 
there for reference purposes. Chapter 6 interrupts the flow, in my 
opinion. As soon as I read the first sentence of the chapter, This 
section describes how LyX can be used to write articles for submission 
to the scientific journal Astronomy and Astrophysics... I figured 
that all of the general stuff was over. But in fact Chapters 7 and 8 
seem much more general than the current Chapter 6.


This seems like a good idea. I suspect many of the sections in Chapter 6 
are probably quite out of date, as well. The bit on koma-script, for 
example, seems to date to something like 2005.


There are 10 instances of the abbreviation i.g.. See, for example, 
Section 3.2.1. Is this an abbreviation of a Latin phrase? Which one?



It looks like these are all meant to be i.e.. I fixed them, too.

Richard

Re: Suggestions for the Additional Features manual

[Richard Heck]

On 01/20/2012 01:02 PM, Scott Kostyshak wrote:

Dear Richard,

Attached are 78 proposed changes for the Additional Features manual. A 
couple of additional issues --



I accepted those changes and committed the new version.

I think that Chapter 6 should be last, either as a chapter or as an 
appendix. I would prefer as an appendix because I think that the main 
document should be something that would be of general interest to many 
people, whereas an appendix could be more for specific cases that are 
there for reference purposes. Chapter 6 interrupts the flow, in my 
opinion. As soon as I read the first sentence of the chapter, "This 
section describes how LyX can be used to write articles for submission 
to the scientific journal Astronomy and Astrophysics..." I figured 
that all of the general stuff was over. But in fact Chapters 7 and 8 
seem much more general than the current Chapter 6.


This seems like a good idea. I suspect many of the sections in Chapter 6 
are probably quite out of date, as well. The bit on koma-script, for 
example, seems to date to something like 2005.


There are 10 instances of the abbreviation "i.g.". See, for example, 
Section 3.2.1. Is this an abbreviation of a Latin phrase? Which one?



It looks like these are all meant to be "i.e.". I fixed them, too.

Richard