April 22, 2017
How do you document your JavaScript? I use JSDoc. It's a tool which goes through your source code, looks at comments, and generates a set of HTML files containing your documentation. Being inline with your code, the documentation is human readable even without generating the documentation. And as a bonus, it is less likely to become outdated as your code evolves.
Stock image: blueprintThis blog post is a short how-to for JSDoc. It describes how to install JSDoc using npm, and how to configure it using a configuration file.We explore how to use JSDoc to document functions, modules, objects, and classes using both ES6 and ES5 syntax.
All examples live on github!
August 19, 2016
Screenshot of the Simian Photo Server displaying gallery thumbnails. This is the third update for the simian photo server project. I finally got the server to generate thumbnails and preview images without crashing my laptop, and now sps displays the actual thumbnails, and the selected picture in the details view. Also visible is the exif data for each picture. Plus, sps now manages camera raw images as well. Most of this is thanks to the wonderful imagemagick library, which will need to be installed on the target machine.
August 19, 2016
Screenshot of SPS gallery view being designed. When I started this project I intended to publish an update every day as I made progress. But neck troubles and an apartment hunt kept me too busy to publish updates, or for that matter, make as much progress as I would have liked. Still, just a few hours short of 2 weeks, here is the status.
August 08, 2016
Stock image: camera with monkey sticker Status update for the Simian Photo Server. We are building with Gulp, and serving with Express. Config, linting, testing, and logging are all good to go!
August 07, 2016
Stock image: camera with monkey sticker The simian photo server project two week challenge.
What are promises and how do you use them?
July 23, 2016
Cartoon; pointing at goal text The goal function. gal, goal, gooal, goooal and so on.
July 23, 2016
Photograph of Haskell B. Curry. A short introduction to currying, and a "How to curry in JavaScript".
November 01, 2015
Screenshot of emails about brute force attacks on Simia code homepage. Spam and brute force attacks nudge me enough to give up Wordpress in favor of a static web-site. Or Everything old is new again.