you should document the function only, with its signature, so that people can see their name to use named arguments IMO.