add doc comments; rename 'list' view to 'index'