In the section "The Static Lifetime", chapter 10-03.
Before:
After:
Here, I'm trying to address two things that I found weird about this paragraph:
The introductory phrase to the paragraph is not specific enough. The first time I read it, my immediate confusion was:
People would suggest I mention lifetimes in error messages to the users of the software that I'm writing? Where would I see such suggestions? In other books? In blog posts? In conference talks? Is this common to suggest mentioning lifetimes in error messages to the users of our software? That's very weird.
It never crossed my mind that this could be a suggestion coming from the compiler, because it doesn't read like it. It reads like it's talking about suggestions from other people (the default kind of suggestion). That was my first impression, at least. Then, the rest of the paragraph was very confusing as I was reading it from that perspective, and it didn't make any sense. I had to read it three times to finally realize I had misread the first phrase, and then it all made sense.
The phrase "and whether you want it to" reads like declaring lifetimes changes lifetimes at the will of the programmer, since it's just a matter of "want". However, in the section "Lifetime Annotation Syntax", a few folds above, it reads:
Lifetime annotations don’t change how long any of the references live. Rather, they describe [...]
That reads more realistic, so I'm assuming that that holds true, and not that declaring lifetimes changes lifetimes. So I would like to propose that we drop the phrasing "and whether you want it to" from this paragraph, since I can't make something live for the entire lifetime of the program just by declaring it with 'static.
In the section "The Static Lifetime", chapter 10-03.
Before:
After:
Here, I'm trying to address two things that I found weird about this paragraph:
The introductory phrase to the paragraph is not specific enough. The first time I read it, my immediate confusion was:
It never crossed my mind that this could be a suggestion coming from the compiler, because it doesn't read like it. It reads like it's talking about suggestions from other people (the default kind of suggestion). That was my first impression, at least. Then, the rest of the paragraph was very confusing as I was reading it from that perspective, and it didn't make any sense. I had to read it three times to finally realize I had misread the first phrase, and then it all made sense.
The phrase "and whether you want it to" reads like declaring lifetimes changes lifetimes at the will of the programmer, since it's just a matter of "want". However, in the section "Lifetime Annotation Syntax", a few folds above, it reads:
That reads more realistic, so I'm assuming that that holds true, and not that declaring lifetimes changes lifetimes. So I would like to propose that we drop the phrasing "and whether you want it to" from this paragraph, since I can't make something live for the entire lifetime of the program just by declaring it with
'static.