documenting scout script functions