more documentation

fixes #55
move index route nearer top of file

- seems like we should order the file with routes
  nearer the root and alphabetically lower values
  nearer the top of the file.
add support for POST new update

Addresses #43