Get your own customer support community
 

(v0.8) Preface/Ch1 - all new typos and grammar errors

A disappointing amount of comma-spliced sentences in here.

Preface, 1, last paragraph:
Third sentence "You can skip..." is a comma splice

Preface, 2, first paragraph, last sentence:
* "[...] you should tell us, send us an email at" - comma splice. Turn that comma into a period.
* Email address "book@sonatype.com" has a footnote with "tobrien@sonatype.com" - why are the addresses different? (Along with Preface, 5, why do email addresses have footnotes at all? Looks weird in PDF.)

1.2 First Paragraph
Looks like there's some extra spacing between sentences after "@Entity."

1.2 Second Paragraph
* "Maven assumes that you want the compile byte code..." - "the" should be "to"
* "Maven's adoption of convention over..." - comma splice. That first comma should be a colon or maybe a hyphen.
* "Maven's strength comes from..." - comma splice.

* "Maven's adoption of convention over..." - comma splice. That first comma should be a colon or maybe a long dash.
* "Maven's strength comes from..." - comma splice.

1.4, first paragraph:
First sentence: comma splice - just end the first sentence at the comma.

1.4, second para:
"But" sentence is awkward (and a comma splice). I suggest replacing with: "Without having to upgrade your Maven installation or install new software, you gained the ability to to execute unit tests in TestNG. You also gained the ability to run annotated JUnit 4 unit tests. You gained all of these capabilities with no action needed on your part. Most importantly..."

1.4, last para:
Suggestion: put "or" in fourth sentence to kill the comma splice: "...in any area of the build, [or] if some..."

1.5, first para:
Awkward (and probably wrong) comma usage in second-to-last sentence. Suggested correction: 'Maven is more than just a "build tool", and more than just an improvement on tools like make and Ant. It is a platform...' (Also, should "make" be in monospace font? GNU's make web docs print it in monospace, and it would scan easier to the eye.)

1.6, first para:
* Second-to-last sentence is a comma splice. Change that first comma to a period or a semi-colon.
* Last sentence: I don't understand what this sentence trying to communicate. The previous sentence already said it's more than a tool. And why's Maven in quotes here when it was never in quotes before? It's probably good to just cut this sentence.

1.6, second para:
* "Maven is much larger than that..." - If you wanted to put the second instance of 'Maven' in quotes here, that would make sense (unlike in the first paragraph).
* Suggestion: In last sentence, change the comma after Gradle to ellipsis (aka dot dot dot).

1.6, last para:
Last sentence: You need to put the word "and" before "universal".

1.7, first para:
"Apache Ant and Apache Maven" appearing twice is a kinda redundant.

1.7, second para:
First sentence is a particularly awful comma splice.

Example 1.1:
Capitalize "file" in this example's title (capitalize all words or no words in these titles)

1.7, para that begins "Admittedly":
'"This is project"' - I bet you mean "This is [a] project"

1.7, second-to-last para:
* Oops: "c`ustom"
* First sentence suggestion: change parens to: "(or even /with/ these supporting technologies)" (those slashes mean italics, of course)
 
sad I’m hating comma splices.
Inappropriate?
1 person has this problem

The company has acknowledged this problem.


User_default_medium