gremlins! fixing a bunch of stuff
adding documentation for core and shells
better