refining documentation and initialization method