update documentation about local scope