mcavage/node-restify — Issue #82: turn on wiki for a "0.5 -> 1.x migration guide"
Author: trentm
Created: 2012-02-22 23:39:47+00:00
State: open

starter content for that:

```
- no `restify.log`, carry your own log along
- can use 'after' event on restify server instead of repeating 'after'
handlers/middleware on every endpoint
- don't *need* a server 'version' field anymore
- server option: serverName -> name
- req.uriParams is gone: use req.params
- new `req.log`, use it, it's good
- server option: 'log' to provide your own Bunyan logger. You probably
want to.
- no default handlers for restify server anymore, you likely need to:

server.use(restify.bodyParser())
... and others

- createServer option: 'apiVersion' is gone (I think), use optional
'version' option to routes.
- add the name of your endpoints:
`server.get({path: '/foo', name: 'GetFoo'}, getFoo)`
This'll be in the logging, helpful for discussion and reference.
- restify.createClient:
- probably want restify.createJsonClient
- drop version
- 'retryOptions' -> 'retry'
- need 'name' field now
- 'log' arg is now a Bunyan logger
- client.get() signature change (ditto head, put, post, del):
- not an input obj, instead client.put(path, payload, callback)
- callback is now `function (err, req, res, obj) {}`, at least
for JsonClient.
- res.sendError() is gone. See
- res.newError() is gone. See
```