(0.7.1) typos/grammar in Chapter 3
Here's some more, Tim:
Chapter 3
There's a general fuzziness around whether coordinates should be single or plural. I'm pretty sure that a single coordinate is one of groupId/artifactId/etc, and one package always has multiple coordinates. Looks like one writer has been using it in singular to refer to those of a single project. (It probably wouldn't hurt to run a word search on singular "coordinate" to double-check all usages.)
And on to the specific items...
3.2 bullet 1
I'm guessing that "artifactID. Simple" should be punctuated "artifactID <simple>" (where <> is constant-width font or something, or maybe just quotes)
3.5.2 first paragraph last sentence
Awkward phrasing.
Current: "For example, the package phase in a project that produces a JAR, means"
Better: "For example, in a project that produces a JAR, the package phase means"
The suggested rewording fits better with the second clause's wording.
Figure 3.3
Is the "install" phase missing from this figure? (I may just not understand it yet)
3.5.2 paragraph "To summarize" (second-to-last paragraph)
"mvn install" in plainfont
3.5.2 last paragraph
"that" should be "than"
3.5.3 second paragraph
"Coordinates" is capitalized here and nowhere else, so I think this is a typo.
3.5.3 third paragraph
* colon after "space" - I think it should just be a comma. The colon just doesn't fit, as nothing before the colon indicates what's coming after. For that matter, "from general to specific" doesn't fit in this sentence anyway; it seems like an orphaned thought. It should either be deleted or given its own sentence.
* "its coordinate is" -- should that be plural "its coordinates are"? In other parts of this chapter, it looks like a single coordinate is considered to be one of the groupId/artifactId/etc elements (though the definition always seems fuzzy).
(Also related: figure 3.5)
(If you look in the final sentence of 3.5.3 and in later places, you'll see that it always used plurally.)
* Last sentence is an ungrammatical 3-in-1 sentence
3.5.4 third paragraph
Second sentence is an ungrammatical 2-in-1 sentence. Also, the 2nd and 3rd sentence could probably be combined and tightened up a bit.
3.5.4 the grey box at the end of the third paragraph
The second "<version>" is inexplicably in a smaller font.
3.5.4 last paragraph
Third sentence terminates abruptly - period should probably be a comma.
</version></simple>
Chapter 3
There's a general fuzziness around whether coordinates should be single or plural. I'm pretty sure that a single coordinate is one of groupId/artifactId/etc, and one package always has multiple coordinates. Looks like one writer has been using it in singular to refer to those of a single project. (It probably wouldn't hurt to run a word search on singular "coordinate" to double-check all usages.)
And on to the specific items...
3.2 bullet 1
I'm guessing that "artifactID. Simple" should be punctuated "artifactID <simple>" (where <> is constant-width font or something, or maybe just quotes)
3.5.2 first paragraph last sentence
Awkward phrasing.
Current: "For example, the package phase in a project that produces a JAR, means"
Better: "For example, in a project that produces a JAR, the package phase means"
The suggested rewording fits better with the second clause's wording.
Figure 3.3
Is the "install" phase missing from this figure? (I may just not understand it yet)
3.5.2 paragraph "To summarize" (second-to-last paragraph)
"mvn install" in plainfont
3.5.2 last paragraph
"that" should be "than"
3.5.3 second paragraph
"Coordinates" is capitalized here and nowhere else, so I think this is a typo.
3.5.3 third paragraph
* colon after "space" - I think it should just be a comma. The colon just doesn't fit, as nothing before the colon indicates what's coming after. For that matter, "from general to specific" doesn't fit in this sentence anyway; it seems like an orphaned thought. It should either be deleted or given its own sentence.
* "its coordinate is" -- should that be plural "its coordinates are"? In other parts of this chapter, it looks like a single coordinate is considered to be one of the groupId/artifactId/etc elements (though the definition always seems fuzzy).
(Also related: figure 3.5)
(If you look in the final sentence of 3.5.3 and in later places, you'll see that it always used plurally.)
* Last sentence is an ungrammatical 3-in-1 sentence
3.5.4 third paragraph
Second sentence is an ungrammatical 2-in-1 sentence. Also, the 2nd and 3rd sentence could probably be combined and tightened up a bit.
3.5.4 the grey box at the end of the third paragraph
The second "<version>" is inexplicably in a smaller font.
3.5.4 last paragraph
Third sentence terminates abruptly - period should probably be a comma.
</version></simple>
1
person has this problem
I have this problem, too!
Tell me when someone solves it.
The more people who report this problem, the more it gets noticed.
The more people who report this problem, the more it gets noticed.
The company marked this problem solved.
-
Inappropriate?I've created a JIRA issue to capture this effort, and I've scheduled it for the 0.7.3 release:
https://issues.sonatype.org/browse/MV...
I’m thankful
-
Inappropriate?FYI, I just pushed the 0.7.3 release. I'm not making a big announcement about this release because I expect to publish a 0.8 release in a few hours.
But, these fixes were included in the 0.7.3 release:
http://www.sonatype.com/books/maven-b...
I’m thankful
1 person says
this solves the problem
-
Inappropriate?Great! Will remember to download the latest version when I have time to get back into the book.
Loading Profile...


EMPLOYEE