StefanSalewski / NimProgrammingBook

Computer Programming with the Nim Programming Language -- A gentle Introduction
259 stars 19 forks source link

Small grammar fixes for clarity #13

Closed marek-lach closed 2 years ago

StefanSalewski commented 2 years ago

Thanks for reporting, have just fixed it, will push to github soon.

types like int, or string, compile

Note that for the second halve of the book I have not yet finished the proof reading pass fixing annotations, so it is not really an oversight: I am writing the plain text first, and then add annotations. That makes more sense, as annotations can interrupt the flow of thinking, and often I rewrite whole sections, so fine annotations get deleted again. That is the style which I used with LaTex writing my diploma- and PhD-Thesis. The actual fix would be

types like [.type]#int#, or [.type]#string#, compile

using a semantic markup. Will fix all that soon.

As some more simple macro example we will show how we can create our own As for some more of a simple macro example, we will show how we can create our own

The correct fix seems to be

As one more simple example, we will show how we can create our own

I have additional added some text about parallel execution for the part called "Advanced Nim" using Nims threadpool. And I have added some remarks about the style of the book under "About this book" as a few people criticized the general textbook style, they seems to prefer crash-course and learning by doing.