godoc

use notes for deprecations
http://godoc.org/go/doc#Note