-
Notifications
You must be signed in to change notification settings - Fork 702
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Book Updates? #509
Comments
Dear Maxim, thanks for feedback! Inconsistencies between printed book and the GitHub repo "should not" be there. But perhaps we have missed something and in this case it would be great to know precisely what you mean. The GitHub repo sometimes contains extra recipes which we did not discuss in the book to avoid a too lengthy discussion or repetition. About intra-chapter consistency: of course we have tried keep a red line but there is always room for improvement and this is a good suggestion and good to know for next time. About next time: we do not have any concrete plans yet but of course we are playing with the idea of a follow-up book project. |
Alright, in the book, chapter 1 recipe 4 section, you introduce "Build_Shared_Libraries" as a way to manage the building of static/shared libraries. Intuitively, I would have liked to see the example, similar to the one in Chapter 1 recipe 5, where you use "Build_Shared_Libraries" with control of outside variables. Then the context switch takes place, out of order, and a new concept is introduced without preface. I was following the flow, nicely, got stomped by how the use of the option was considered while "Build_Shared_Libraries" case was dropped altogether. I began to modify the recipe 4 with "Build_Shared_Libraries" hoping that recipe 5 would be flowing into the use of that variable. To only find out that I was just completely omitted. It would have been nice to see you continue to introduce "Build_Shared_Libraries" and (alternative, currently mentioned in the GitHub) as a solid conclusion to the section. This would allow the view of the two approaches without confusing context switch. If you re-read Ch1 Section 4 (recipe 4) through Section 5 (recipe 5), you will see what I mean. I hope this helps you and I very much appreciate your wonderful effort you've put forth thus far with this book. Kudos to that. |
I just started working through the book and find that there are several inconsistencies with the book and recipes. Any plans to update the book to have a consistent flow. For example, chapter 1 recipe 5 suddenly changes the topic and loses consistency with recipe 4 from the same chapter. Though I'm able to follow it, somewhat, it does make it less coherent when such takes place.
The text was updated successfully, but these errors were encountered: