Golang - lack of information about named return values in functions

I felt that the bit about named return values in functions was a fairly significant omission. Hopefully I am not the only one who thinks so. At least from the standpoint of someone who might be new to go, knowing what it is helps when that newcomer is looking at someone else's code and encounters this style of function declaration.
You're right @szaydel, the original way you had it was better. I thought it could be shrunk down a little bit to keep the doc as concise as possible but I realized the shrunk down version loses some details. 

So if you could revert back to the way it was, I will get it merged in. Thank you for the cooperation!