updated dev script & added some documentation