added package level docs
added forEach to lists