Get your own customer support community
 

Grammar errors in Preface and Chapter 1.

Reading this book for the first time. Version is 0.7.1. Is this the right place to report grammar issues? I'm a grammar pedant, so I have a lots of niggling feedback. So far I'm just through the Preface and Chapter 1.

Before I start, I must say that some author on this book has a serious jones for putting two independent clauses into a sentence separated by just a comma. That guy (or gal?) needs to get punched in the arm. Either use a conjunction like "and", or better yet, just make two sentences. A semicolon may also be approprate in some cases.

And here's what I have for you:

Preface: 1. Second paragraph, sentence starting "Part II..."
Sentence is not grammatical: two independant clauses separated by a comma. The comma after 'reference' should probably be a period (or perhaps a semi-colon).

Preface: 2.
Email in prose is book@, email in footnote is tobrien@.

Preface: 3.
"Italic" not italic. Given the other font entries, it's seems clear that it is supposed to be.

Preface: 4. "plugin" paragraph
The intention of this paragraph is unclear. Is all of this merely about the choice of hyphenation? Would I find the hyphenated version in a dictionary? May I suggest the following instead:
'While "plug-in" (with hyphen) would be the grammatically correct form, this book writes the term as "plugin" both because it is easier to read and write and because it is a standard throughout the Maven community.'

I would argue that the "easier to read and write" part is unnecessary and can be cut. The mere fact that unhyphenated is a community standard should be reason enough.

1.3 First sentence
Missing "a" before "fully"?

1.4 Last paragraph
The first comma (after "Surefire plugin") should probably be a colon.

1.5 Dependency Management paragraph
Missing word. Should "by" be after "defined"?

1.5 Universal Reuse paragraph
Last sentence is grammatically incorrect and I don't fully understand what it's trying to say. And is "model" capitalized or not? You can't do both (without good reason)...

1.5 Last sentence
Not really an error, but isn't "foundation" and "beginnings" the same thing? You could strike "for the beginnings" without changing the meaning.

1.6 2nd paragraph, last sentence
"Nexus is introduced..." - this sentence has nothing to do with the theme of the paragraph. At best, it should be parenthesized, but really it doesn't need to be here at all.

1.7 1st paragraph
strike that "the" before "Apache Ant"

1.8 1st sentence
Sentence is ungrammatical: two independant clauses separated by a comma. Furthermore, the first clause just looks wrong. (This text sure has a lot of instances where two standalone clauses are separated by a single comma. This is not legal! Stop it!)

1.8 entire section
Commands like "mvn install" and such should be in the proper font for commands (according to Preface 3, it should be constant width bold, I think). As a newbie to Maven, I'm guessing "mvn site" is a command, but this is the first time I've seen it.

1.8 paragraph "Admittedly, this is ..."
Sentences 2 and 3 are not sentences, they are fragments.

1.8 Apache Ant first bullet
Another ungrammatical two-in-one sentence.

1.8 Apache Ant second bullet
Yet another ungrammatical two-in-one sentence.

1.8 Apache Ant second bullet
And yet another ungrammatical two-in-one sentence!

1.8 Apache Maven first bullet
Argh!

1.8 Apache Maven third bullet
Comma after "lifecycle" is completely unnecessary.

1.8 Paragraph "Maven has built-in..."
Multiple issues.
* Missing comma between "tests" and "place"
* "you" should be "your"
* "(war)" - why parens?
* last sentence could use some refining. At minimum, put "then" before "execute" near the end.
 
sad I’m disappointed
Inappropriate?
1 person has this problem

The company marked this problem solved.


User_default_medium