added spec, fixed a couple documentation specifics