minor refactoring
shak doc, also fits ska generally