X Tutup
Skip to content

Pr/372#378

Merged
KostyaSha merged 4 commits intodocker-java:masterfrom
KostyaSha:pr/372
Nov 30, 2015
Merged

Pr/372#378
KostyaSha merged 4 commits intodocker-java:masterfrom
KostyaSha:pr/372

Conversation

@KostyaSha
Copy link
Copy Markdown
Member

More reworked #372

@marcuslinke for review

@marcuslinke we should define what to do with javadocs, annotating only field sounds logical, but getter/setter should also provide docs. Didn't found way inherit field javadoc to methods.
Probably it makes sense annotate field and provide link to it from getter WDYT?

@marcuslinke
Copy link
Copy Markdown
Contributor

LGTM 👍 Really appreciate yor work. However, do you really want to investigate the remote API version for each single property? This seems to be really much effort. For me personally this effort would be to much because of my limited time resources.

@KostyaSha
Copy link
Copy Markdown
Member Author

@marcuslinke it very convenient when implementing something to rely on features. I will try sync existed and we should require javadocs for new PRs imho. Plus i usually digging into depth when using tools :D

@KostyaSha
Copy link
Copy Markdown
Member Author

Let's experiment, i will keep docs under fields and link from getters. Should be easy move them later.

@KostyaSha KostyaSha force-pushed the pr/372 branch 4 times, most recently from 5f5f652 to ba0255c Compare November 20, 2015 22:16
@KostyaSha KostyaSha added this to the 3.0.0 milestone Nov 20, 2015
@KostyaSha KostyaSha self-assigned this Nov 20, 2015
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@marcuslinke please check, btw why nested classes are used? Can they be extracted into model objects?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nesting classes makes sense when the inner class is used only in the context of the surrounding class and not anywhere else. Beside this it also documents the classes relationship in my oppinion.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But you will have only field with cleaner class instead.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Keeping as is.

@KostyaSha
Copy link
Copy Markdown
Member Author

No objections - merging.

KostyaSha added a commit that referenced this pull request Nov 30, 2015
@KostyaSha KostyaSha merged commit 58d9407 into docker-java:master Nov 30, 2015
@marcuslinke
Copy link
Copy Markdown
Contributor

@KostyaSha Please add to CHANGELOG

@KostyaSha
Copy link
Copy Markdown
Member Author

@marcuslinke i will sync milestone to changelog later

@marcuslinke
Copy link
Copy Markdown
Contributor

👍 Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

X Tutup