Talk:Reviewers:MartinRinardNotes
From APIDesign
(Redirected from Talk:Part 1 Overall Feedback)
Re. target audience: it should have been explained in the preface, everyone. However I do understand your comment and I am glad that you represent this point of view. That is exactly why I asked you to be the reviewer ;-)
Re. a lot of examples: I will do that, but not in the beginning. Examples without explanation are useless, although common, especially in empiricism/pragmatism. Rationalists need theory first. But there is the intro to the theory part that says, you can skip it, if you feel bored - I do not think I can do much more.
I've addressed this in 2b70ddb6c1d2
Re. comfort zone vs. treatise - true, but I am not sure I'll be able to change that completely.