Regarding named parameters, in the future (I don't want you to redo your whole PR :) ) I think we should stick to bradfitz guide: https://code.google.com/p/go-wiki/wiki/Style#Named_Result_Parameters

In a nutshell, named result parameters are useful, for docs, only if the function return multiple parameters with the same type.