Skip to content
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

Open
mlevkov opened this issue Mar 21, 2019 · 2 comments
Open

Book Updates? #509

mlevkov opened this issue Mar 21, 2019 · 2 comments

Comments

@mlevkov
Copy link

mlevkov commented Mar 21, 2019

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.

@bast
Copy link
Member

bast commented Mar 21, 2019

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.

@mlevkov
Copy link
Author

mlevkov commented Mar 21, 2019

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants