-
Notifications
You must be signed in to change notification settings - Fork 175
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add Scaladoc for forProduct
methods
#424
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM! Thanks for this! I just left a comment on a small nitpick. Feel free to ignore it.
|
||
[2..22#final def forProduct1[B, [#A0#]]([#keyA0: String#])(f: ([#A0#]) => B)(implicit | ||
[2..22# | ||
/** |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nitpick: Can you move this to the line above and add an extra line before the [2..22#...
? Just so that the methods only have a blank line between them in the generated code. The same thing applies for ProductWriters
.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sure, fixed in 3076681.
/** | ||
* Builds a `ConfigReader` for an object created from the values of 1 keys. | ||
* | ||
* @param f the function converting the tuple of values to the target object |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nitpick: I may be wrong, but I don't think it's a tuple so much as an argument list. Were it a tuple, it'd have to be written as f: ((A0, A1)) => B
I suggest wording it as @param f the function constructing the target object from the read config values
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Indeed, they're not tuples. Corrected it in 766a323.
Adds Scaladoc for the new methods so that basic documentation is available for them. Even though it was possible to generate the
@param
entries for thekeyN
parameters, I opted not to do that since I think that it would actually make the Scaladoc pages less readable.