update readme

README.md

@@ -34,12 +34,20 @@ This crate is an extension to the popular [gotham web framework][gotham] for Rus
 create resources with assigned methods that aim to be a more convenient way of creating handlers
 for requests.
 
-## Design Goals
+## Features
 
-This is an opinionated framework on top of [gotham]. Unless your web server handles mostly JSON as
+ - Automatically parse **JSON** request and produce response bodies
-request/response bodies and does that in a RESTful way, this framework is probably a bad fit for
+ - Allow using **raw** request and response bodies
-your application. The ultimate goal of gotham-restful is to provide a way to write a RESTful
+ - Convenient **macros** to create responses that can be registered with gotham's router
-web server in Rust as convenient as possible with the least amount of boilerplate neccessary.
+ - Auto-Generate an **OpenAPI** specification for your API
+ - Manage **CORS** headers so you don't have to
+ - Manage **Authentication** with JWT
+ - Integrate diesel connection pools for easy **database** integration
+
+## Safety
+
+This crate is just as safe as you'd expect from anything written in safe Rust - and
+`#![forbid(unsafe_code)]` ensures that no unsafe was used.
 
 ## Methods