changed method scope, updated docs