Conversation
shahabhijeet
left a comment
There was a problem hiding this comment.
@leonardbf you are releasing your first SDK + your swagger is still in preview.
Please make changes as suggested to publish your SDK in preview.
Please use the generate.ps1 to generate your SDK.
If you use generate.ps1, it creates the appropriate meta data that is required for the SDK.
| <Description>Provides NetApp storage management capabilities for Microsoft Azure.</Description> | ||
| <AssemblyTitle>Microsoft Azure NetApp Management</AssemblyTitle> | ||
| <AssemblyName>Microsoft.Azure.Management.NetApp</AssemblyName> | ||
| <Version>1.0.0</Version> |
There was a problem hiding this comment.
@leonardbf if you are going as your v1, I recommend you go as preview and mark your version as 0.9.0-preview
There was a problem hiding this comment.
ok, changed to 0.9.0-preview.
| <PackageTags>MicrosoftAzure Management;NetApp</PackageTags> | ||
| <PackageReleaseNotes> | ||
| <![CDATA[ | ||
| * Initial version |
There was a problem hiding this comment.
@leonardbf if this is your first version, please provide any links to your service or provide a description what this SDK will allow customers to do.
This is your first version that will let developers know what this service is about and what can be done with it.
If you have links to samples, provide that also.
There was a problem hiding this comment.
ok, description added, including some examples. Note that a more formal description is pending anyway.
| <PropertyGroup> | ||
| <TargetFrameworks>net452;netstandard1.4</TargetFrameworks> | ||
| </PropertyGroup> | ||
| <ItemGroup Condition="'$(TargetFramework)' == 'net452'"> |
| { | ||
| return new Tuple<string, string, string>[] | ||
| { | ||
| new Tuple<string, string, string>("NetApp", "Accounts", "2017-08-15"), |
There was a problem hiding this comment.
@leonardbf why your API version is not tagged appropriately.
I see the swagger is inside a preview directory, but the API itself is marked as stable.
Please clarify if your service is preview or is it stable?
There was a problem hiding this comment.
The API is being made public but at this time is still subject to more change than will be expected later. Therefore prefer to leave as preview for now.
| [assembly: AssemblyCulture("")] | ||
| [assembly: NeutralResourcesLanguage("en")] | ||
|
|
||
| [assembly: AssemblyVersion("1.0.0.0")] |
There was a problem hiding this comment.
Please update the version number here too
| <!-- Please do not move/edit code below this line --> | ||
| <Import Condition=" Exists('$([MSBuild]::GetPathOfFileAbove(AzSdk.RP.props))') " Project="$([MSBuild]::GetPathOfFileAbove('AzSdk.RP.props'))" /> | ||
| <!-- Please do not move/edit code above this line --> | ||
| </Project> |
There was a problem hiding this comment.
nit: remove trailing lines
| <PropertyGroup> | ||
| <PackageId>NetApp.Tests</PackageId> | ||
| <Description>NetApp.Tests Class Library</Description> | ||
| <VersionPrefix>1.0.0</VersionPrefix> |
There was a problem hiding this comment.
Replace VersionPrefix with Version
| <Description>NetApp.Tests Class Library</Description> | ||
| <VersionPrefix>1.0.0</VersionPrefix> | ||
| <Authors>Microsoft Corporation</Authors> | ||
| <AssemblyName>NetApp.Tests</AssemblyName> |
There was a problem hiding this comment.
Please add <TreatWarningsAsErrors>true</TreatWarningsAsErrors> here and fix all errors
| netAppMgmtClient.Accounts.CreateOrUpdate(netAppAccount, ResourceUtils.resourceGroup, ResourceUtils.accountName1); | ||
| Assert.True(false); | ||
| } | ||
| catch (Exception ex) |
There was a problem hiding this comment.
Consider using Assert.Exception here
There was a problem hiding this comment.
This was actually already considered but was unavailable. Leaving as is.
With review corrections.
dsgouda
left a comment
There was a problem hiding this comment.
Looks good apart from a minor comment. Please address it in a later commit,
| <PackageId>NetApp.Tests</PackageId> | ||
| <Description>NetApp.Tests Class Library</Description> | ||
| <AssemblyName>NetApp.Tests</AssemblyName> | ||
| <Version>1.0.0-preview</Version> |
There was a problem hiding this comment.
nit: Test projects must always be versioned as 1.0.0
From new swagger spec Azure/azure-rest-api-specs#4891
(NetApp internal ticket NFSAAS-1504)
Description
This checklist is used to make sure that common guidelines for a pull request are followed.
General Guidelines
Testing Guidelines
SDK Generation Guidelines
*.csprojandAssemblyInfo.csfiles have been updated with the new version of the SDK.