Improve scaladoc

Currently very sparse, at the minimum add some examples to the top-level package, and also document the main classes Arctic, Library, and TickStore.