Book Review: Learning JavaScriptMVC

Packt Publishing [1] invited me to review the recently published Learning JavaScriptMVC [2] by Wojciech Bednarski [3]. I describe my impressions of this book on JavaScriptMVC [4] in this post. Before beginning my review, I'll quote the description of JavaScriptMVC [5] from its web site [6]: "A collection of the best practices and tools for building JavaScript applications" that is "built on top of jQuery." I reviewed the ebook (PDF) version of Learning JavaScriptMVC.

Learning JavaScriptMVC: Learn to build well-structured JavaScript web applications using JavaScriptMVC [2] is a 100+ page book with six chapters. The Preface states that readers should "be familiar with JavaScript, browser APIs, jQuery, HTML5, and CSS." It also states that the book is intended "for anyone who is interested in developing small- and mid-size web applications with the JavaScriptMVC framework [7], which is based on the most popular JavaScript library – jQuery."

Chapter 1: Getting Started with JavaScriptMVC

The first chapter [8] introduces "JavaScriptMVC [4] (JMVC [9])" as "a JavaScript [10] open source model-view-controller (MVC) framework" built "on top of the jQuery [11] library." The chapter describes other aspects of JavaScript MVC such as historical details, basic objectives, license information, JavaScriptMVC architecture, the four major components of JavaScriptMVC (StealJS [12], FuncUnit [13], jQueryMX [14], and DocumentJS [15]), and links for more information. A paragraph in this first chapter discusses future plans to rename (DoneJS [16] (jQuery++ [17]) and CanJS [18]) and make changes to the JavaScriptMVC framework and to some of its major components.

Chapter 1 includes details on three different approaches for installing JavaScriptMVC. One of the demonstrated approaches is via Vagrant [19] and Oracle VM VirtualBox [20].

The first chapter also demonstrates using JavaScriptMVC with a sample application that can be compared to a similar sample to-do application [21] built with other web frameworks at https://github.com/tastejs/todomvc/tree/gh-pages/architecture-examples [22]. Several common web development techniques and tools are covered as part of this example: Google Chrome Inspector [23], jQueryMX, and Embedded JavaScript [24] (EJS).

Chapter 2: DocumentJS

Chapter 2 [25] covers DocumentJS [15], which it introduces as "a powerful, yet simple tool designed to easily create searchable documentation for any JavaScript codebase." I think it's worth re-emphasizing here that this is an independent tool that can be used with any JavaScript code base and is not limited to use on JavaScriptMVC applications.

Bednarski states in this second chapter that DocumentJS is quickly learned by anyone familiar with JSDoc [26], YUIDoc [27], YARD [28], or other Javadoc documentation tools. He also cites DocumentJS's support for Markdown [29] as one of its advantages. This chapter adds documentation comments (look and feel a lot like Javadoc) to the code introduced for the sample application in Chapter 1 before covering how to generate documentation from these special source code comments.

Chapter 3: FuncUnit

The third chapter [30] is devoted to FuncUnit, which it describes as "a functional testing framework with jQuery-like syntax" that "is built on top of the QUnit [31] unit test framework." The chapter contrasts [32] functional testing to unit testing and demonstrates using related tools Selenium [33], PhantomJS [34], and Envjs [35] along with Maven [36] and Jenkins [37].

Chapter 4: jQueryMX

The fourth chapter [38] focuses on jQueryMX [14] and describes jQueryMX as "a collection of jQuery libraries that provides functionality necessary to implement and organize large JavaScript applications." The chapter covers several jQueryMX plugins such as jQuery.Class [39] (based [40] on John Resig [41]'s Simple JavaScript Inheritance [42]), jQuery.Model [43], and jQuery.View [44].

Chapter 5: StealJS

Chapter 5 [45] covers StealJS and describes it as an "independent code manager and packaging tool." The chapter also states that "StealJS requires Java 1.6 or greater." The chapter demonstrates using StealJS to load files, to log, to clean/beautify code, to concatenate and compress code, . Related tools mentioned in this chapter include Google Closure [46] and JSLint [47].

Chapter 6: Building the App

The final chapter [48]'s stated goal is "to show how to build a real-word application from concept
through design, implementation, documentation, and testing." Along the way, the chapter mentions many process-related issues including use of Trello [49], Trac [50], JIRA [51], and Git [52]. The example in the chapter also demonstrates using IndexedDB [53], PouchDB [54], and Sass [55].

Similarly to the first chapter, the last chapter is code-intensive as the entire application's code base is included in the chapter.

Positives

Conciseness - The author limits background details and opinions to sentences rather than the normal paragraphs or pages many authors devote to background and opinions.
Code Examples - The book is code-heavy with numerous pages devoted to code listings and to commands for running various tools.
Frame of Reference - This book's most useful feature may be that it provides an overall frame of reference for understanding what the JavaScriptMVC framework is. With the overall framework understood at a high level, the reader can go to other resources for additional or more in-depth details.
References - The book's conciseness (just over 100 pages total) leaves many details out and so it is helpful that it has numerous references to online resources with additional details.
Truth in Advertising - The book's preface stated that this book is intended for readers familiar with "JavaScript, browser APIs, jQuery, HTML5, and CSS." This is not overstated; the heavy use of code (especially JavaScript) means that the book is going to be much more useful to those already familiar with JavaScript and related technologies than those not familiar with those technologies. As the "Learning" part of the title implies, this book is an introductory book rather than a detailed reference book.

Negatives

Grammar and Sentence Structure - One of the advantages traditionally associated with books when compared to blogs is better spelling, grammar, and sentence structure in books. This is typically because books (and even articles) typically have much more editorial process than blog posts (the latter of which often have no editorial process). Unfortunately, much of this book felt like very little editing had occurred in the book publication process. There were numerous disjoint sentences and a couple cases where the chosen words did not seem to be used properly in the context in which they were used.
Good Online Documentation - This is really not a disadvantage of Learning JavaScriptMVC, but I thought it worth pointing out for those trying to decide whether to purchase the book. The online documentation for JavaScriptMVC [56] seems fairly thorough and clear and might be sufficient for those wanting to learn and use JavaScriptMVC. In fact, the JavaScriptMVC documentation even includes its own To-Do example application [21]. I often prefer having a printed or electronic copy of a book because they have some advantages, but this is also a matter of taste. It is important to reiterate that this book is an introductory book rather than a reference book.

Conclusion

I was happy to read Learning JavaScriptMVC and become more acquainted with JavaScriptMVC and how it fits in with other popular web development technologies and tools. This book seems best suited for developers who are about to use JavaScriptMVC without significant previous experience using that framework but with experience with JavaScript and other common web technologies. Learning JavaScriptMVC provides a different introductory perspective than the well-written online documentation and is filled with code examples demonstrating the concepts.

Original posting available at http://marxsoftware.blogspot.com/ [57] (Inspired by Actual Events)

Links:
[1] http://www.packtpub.com/
[2] http://www.packtpub.com/building-javasript-web-applications-using-javascriptmvc/book
[3] http://www.packtpub.com/authors/profiles/wojciech-bednarski
[4] http://javascriptmvc.com/
[5] http://en.wikipedia.org/wiki/JavaScriptMVC
[6] http://javascriptmvc.com/follow.html
[7] http://javascriptmvc.com/docs.html
[8] http://www.packtpub.com/building-javasript-web-applications-using-javascriptmvc/book#chapter_1
[9] http://bitovi.com/blog/2010/02/talkin-javascriptmvc-is-hard.html
[10] https://developer.mozilla.org/en-US/docs/Web/JavaScript
[11] http://jquery.com/
[12] http://javascriptmvc.com/docs.html#!stealjs
[13] http://javascriptmvc.com/docs.html#!FuncUnit
[14] http://javascriptmvc.com/docs.html#!jquerymx
[15] http://javascriptmvc.com/docs.html#!DocumentJS
[16] http://donejs.com/docs.html#!
[17] http://donejs.com/docs.html#!jquerypp
[18] http://canjs.com/
[19] http://www.vagrantup.com/
[20] https://www.virtualbox.org/
[21] http://javascriptmvc.com/docs.html#!todo
[22] https://github.com/tastejs/todomvc/tree/gh-pages/architecture-examples
[23] https://developers.google.com/chrome-developer-tools/
[24] http://embeddedjs.com/
[25] http://www.packtpub.com/building-javasript-web-applications-using-javascriptmvc/book#chapter_2
[26] http://usejsdoc.org/
[27] http://yui.github.io/yuidoc/
[28] http://yardoc.org/
[29] http://daringfireball.net/projects/markdown/
[30] http://www.packtpub.com/building-javasript-web-applications-using-javascriptmvc/book#chapter_3
[31] http://qunitjs.com/
[32] http://stackoverflow.com/questions/2741832/unit-tests-vs-functional-testing
[33] http://docs.seleniumhq.org/
[34] http://phantomjs.org/
[35] http://www.envjs.com/
[36] http://maven.apache.org/
[37] http://jenkins-ci.org/
[38] http://www.packtpub.com/building-javasript-web-applications-using-javascriptmvc/book#chapter_4
[39] http://javascriptmvc.com/docs.html#!jQuery.Class
[40] http://javascriptmvc.com/docs.html#!mvc.class
[41] http://ejohn.org/about/
[42] http://ejohn.org/blog/simple-javascript-inheritance/
[43] http://javascriptmvc.com/docs.html#!jQuery.Model
[44] http://javascriptmvc.com/docs.html#!mvc.view
[45] http://www.packtpub.com/building-javasript-web-applications-using-javascriptmvc/book#chapter_5
[46] https://developers.google.com/closure/
[47] http://www.jslint.com/
[48] http://www.packtpub.com/building-javasript-web-applications-using-javascriptmvc/book#chapter_6
[49] https://trello.com/
[50] http://trac.edgewall.org/
[51] http://en.wikipedia.org/wiki/JIRA
[52] http://git-scm.com/
[53] https://developer.mozilla.org/en-US/docs/IndexedDB
[54] http://pouchdb.com/
[55] http://sass-lang.com/
[56] http://javascriptmvc.com/docs.html#!
[57] http://marxsoftware.blogspot.com/