shell.js: commented and documented process thusfar