add some documentation remove swagger doc

swagger doc was not generated correctly according to the grape doc