updating guide and scala docs