grzesiek-galezowski / tdd-ebook

Test-Driven Development - Extensive Tutorial. Open Source ebook
https://leanpub.com/tdd-ebook
Other
361 stars 57 forks source link

Change some subsections into sections (Three essential tools) #34

Closed martinmoene closed 9 years ago

martinmoene commented 9 years ago

Aim for a table of contents that reads as an overview of the book.

martinmoene commented 9 years ago

I'd like to suggest to change the chapter title from:

The three most essential tools

to

Three essential tools

"It doesn't make sense" ( ;-) ) to use most in combination with essential. Something is essential or it is not, it doesn't allow for ranking.

or to

The three most important tools

If you do not deem them all essential (e.g. Anonymous value generator, Mocking framework).

grzesiek-galezowski commented 9 years ago

Agree on "most essential" -> "essential" - please add it to the pull request. By the way, I agree it might make sense to change "xUnit framework" to "Test framework", although I think it forces making a change to the next line, which says: "The first and most essential tool we are going to use is an xUnit framework.".

We can apply the "most essential" fix here as well and write it as something like: "The first of the essential tools we are going to use is a test framework - a tool for running our tests."

What do you think?

martinmoene commented 9 years ago

Yeah, I already noticed that the sentence would have to change, but postponed that (untill now).

.... thinking ....

martinmoene commented 9 years ago

How about (something like): The first essential tool we'll use is a test framework. A test framework allows us to specify and execute our tests.

grzesiek-galezowski commented 9 years ago

looks good. Please add it to the pull request and I'll merge it.

martinmoene commented 9 years ago

Done.