-
Notifications
You must be signed in to change notification settings - Fork 1.9k
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
Random features and bug fixes #1939
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.
inline suggestion to also use Javadoc's @deprecated
with a helpful comment
@@ -16,8 +16,10 @@ | |||
/** Windows Server 2012 R2 Data center. */ | |||
WINDOWS_SERVER_2012_R2_DATACENTER("MicrosoftWindowsServer", "WindowsServer", "2012-R2-Datacenter"), | |||
/** Windows Server 2016 technical preview with container support. */ | |||
@Deprecated |
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.
in addition to the annotation, we can also put in a Javadoc tag @deprecated
and say what to do instead (e.g. see ApplicationGatewayBackendHttpConfiguration.java)
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.
done, please review.
…tualMachineImage and KnownWindowsVirtualMachineImage
/** OpenSUSE-Leap 42.1. */ | ||
/** | ||
* OpenSUSE-Leap 42.1. | ||
* @deprecated use withLatestLinuxImage("SUSE", "openSUSE-Leap", "42.3") instead. |
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.
when I used the method name without #
in the Javadoc, i got a warning in Eclipse. Does javadocs still resolve this reference properly when no #
is used? (in other words: #withLatestLinuxImage(...)
)
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.
thanks!, updated PR so that these references resolve properly.
Addresses -