added scope(), big docs update