a few more function comments
abstract out making index pages