updated docs; small method relocation change