missing routes, file name fix, documentation and some minor improvement

we are not using haml