“The JavaScript Garden”, an excellent JS resource

For those who are recent arrivals into the world of JavaScript, I highly recommend “The JavaScript Garden”. The website – essentially one very long article, broken into sections for ease of navigation – offers an excellent introduction to all things JavaScript. Per the description:

JavaScript Garden is a growing collection of documentation about the most quirky parts of the JavaScript programming language. It gives advice to avoid common mistakes and subtle bugs, as well as performance issues and bad practices, that non-expert JavaScript programmers may encounter on their endeavours into the depths of the language.

The JavaScript Garden still assumes some familiarity with JavaScript/programming, but it starts off at a pretty basic level, and builds up the reader’s knowledge from there.

One thing to note for both the JavaScript Garden, and any other JS reference I’ve ever seen in my life: for some reason, folks are fascinated with describing how bizarre the JavaScript notion of classes and prototypes is. While I don’t disagree that the JS notion is indeed bizarre, for purposes of just Office.js programming, you won’t need to create JS classes – all you’ll be doing is using them, which is no different than using any other JS object. Moreover, if you decide to go with TypeScript rather than plain ol’ JavaScript, you won’t even need to understand the strange prototype model. So, in my humble opinion, you can safely skip the section on “The Prototype” (i.e., classes) within the JavaScript Garden site, and any other reference that tries to bamboozle you with this topic. While classes might be helpful for compartmentalizing your logic – and while they might be essential for use in frameworks like Angular 2, which you might use alongside Office.js – the understanding of how JavaScript classes are structured/created is not necessary for using Office.js.

For all the rest of the topics, the content found in the “JavaScript Garden” is an excellent read.