change constructor init; add docs
docs