Added more informative documentation to publicly exposed parts of
spades.js