Feedback from my first impression of PyMC3 chapter

[amcknight]

The language is very specific and clear.

There is a lot of assumed knowledge that made it difficult for me to follow some of it. Maybe be a bit more clear about what you assume the reader knows at the beginning of the chapter? Maybe this is covered in earlier chapters.

I would have liked many more links, specifically to terms you use. (for instance, no links to Theano, HMC, NUTS)

Some other little notes:
Confusing:
"After successfull installation, PyMC3 can be installed using pip:"
After successful installation of what?
"The final piece of the model, Y_obs, is an observed stochastic, and represents the data likelihood of the model"
I found this confusing but I'm not sure if it's just because of my unfamiliarity with some stats terminology. Is there a better way to say "data likelihood of the model"?
"Perhaps we are now trying to predict the values of Y that are greater than zero:"
Saying perhaps here makes it sound like we're guessing what's happening. A little clunky.
Assumes I know what GLM is
Should maybe put "(GLM)" after first use of general linear model rather than in its section near the end.
Conclusion ends abruptly, mid-sentence

Typos:
obivated
successfull
withing
"we have instantiate a step method"
"might not be possible to write a probability distributions"
"mathematical simplifications of the and caching"

I guess that's it. It seems very solid, though not very beginner friendly, but maybe that's fine given the context of the book.

[jsalvatier]

Thanks for the feedback Andrew, I appreciate it a lot.

Would you mind expanding on which parts were difficult to follow? What things did you feel like were assumed?

[twiecki]

Thanks @amcknight, that's very valuable and we'll improve those parts!