runner: cosmetic changes

Add few doc strings and rename some functions etc.