docs + added return value from script