openframeworks/ofBook — pull request #76 by mikewesthad (2014-09-04 15:40:43+00:00)
Title: Comments and feedback for ofSketch chapter

@brannondorsey Great chapter! Overall, clear and concise. And again, I’m pumped to see ofSketch get included in this release of ofBook. It’s going to be a fantastic resource for beginners who are tackling the book.

I like how the chapter is laid out for the beginner - from simple to complex. That said I think that the first part – “What is ofSketch” – might benefit from a more detailed description of what ofSketch is. A very general description of the difference between the front end and the back end would be plenty. It doesn’t have to be long either – it could just be a diagram – but it would give beginners an idea of why you must both run an app and open your browser.

Along the same lines, you refer to both the ofSketch executable and the browser interface as “ofSketch.” I think that might be a little confusing to someone trying ofSketch for the first time. You can also address this in your diagram/description of what ofSketch is.

In “Getting Started With ofSketch”, you could show off a picture of one of your examples running and/or give the reader a specific example to check out.

One last thing – and I get it if it’s too much work – but it might be cool to integrate some of the code from the other chapters into the examples packaged with ofSketch. I’m thinking especially in terms of the early chapters, but it’d work well with the majority of the chapters. I’d be happy to bring my code into ofSketch style.

Aside from that – comments are in line in the chapter. Small changes I just made directly, larger things I made note of with **[mh: note]**.

Nice job putting this together so quickly.