Some chapter 1 grammar/flow suggestions#105
Some chapter 1 grammar/flow suggestions#105burlingsmith wants to merge 8 commits intopedropark99:mainfrom
Conversation
Primarily minor grammar fixes, but a few suggestions included for sentences I found confusing.
|
I assign the copyright of this contribution to Pedro Duarte Faria |
|
Thank you @burlingsmith for your contribution! I will take a look at it 😉 |
pedropark99
left a comment
pedropark99
left a comment
There was a problem hiding this comment.
I don't have time right now to review everything, so I will come back here soon. But this is what I've spotted so far.
| This phrase is specially true for C++ programmers. Because C++ is a gigantic language, | ||
| with tons of features, and also, there are lots of different "flavors of C++". These elements | ||
| are what makes C++ so complex and hard to learn. Zig tries to go in the opposite direction. | ||
| This phrase is especially true for C++ programmers because C++ is a gigantic language, |
There was a problem hiding this comment.
I prefer to end the phrase in the "programmers" with the final dot. It feels a better reading flow to me.
| This phrase is especially true for C++ programmers because C++ is a gigantic language, | |
| This phrase is especially true for C++ programmers. Because C++ is a gigantic language, | |
There was a problem hiding this comment.
The problem with that is that it makes the rest of the line (starting with "because") a dependant clause, i.e. not a complete sentence. The simplest way to fix this is to remove the word "because." You could opt to rather combine the dependant clause with the next sentence, which would require more significant rewriting of the second sentence. Here are the two possible results:
This phrase is especially true for C++ programmers. C++ is a gigantic language, with tons of features and lots of different C++ “flavors.” These elements are what make C++ so complex and hard to learn.
This phrase is especially true for C++ programmers. Because C++ is a gigantic language, with tons of features and lots of different “flavors," C++ is notoriously complex and hard to learn.
There are other ways to make it work, to be sure, but these are my personal suggestions.
| your C code. With macros, you are no longer 100% sure about which pieces | ||
| of the code are being sent to the compiler, i.e. | ||
| they obscures the actual source code that you wrote. | ||
| The phrase above is still important for C programmers too because, even with C being a simple |
There was a problem hiding this comment.
Once again, ending the phrase with the dot, gives me a better reading flow here. Although you did some nice changes in this paragraph.
| The phrase above is still important for C programmers too because, even with C being a simple | |
| The phrase above is still important for C programmers too. Because, even with C being a simple | |
There was a problem hiding this comment.
Again, you are trying to use the word "because" to link two sentences, and that requires a comma. Since your paragraph is well structured—I mean, the first sentence tells you what the paragraph is about—you don't really need the word "because" here, and I would suggest removing it to make the paragraph grammatically correct but maintain the pause that you are indicating with the period.
|
|
||
| By being a simpler language, Zig becomes much more clear and easier to read/write, | ||
| but at the same time, it also achieves a much more robust state, with more consistent | ||
| By being a simpler language, Zig becomes much clearer and easier to read and write |
3 participants
Some grammar or flow fixes I noted down while starting to read the book. Primarily minor grammar fixes, but a few suggested changes to sentences I found confusing.
Please let me know if you have any questions or if this is not the sort of contribution you are looking for. Thank you!