Azure-docs: Documentation seems outdated / 404 link to samples

[tebeco]

Hello,

As I was trying to update an application to use SDK 12 for Azure.Storage.Blob using locks I found this page in order ot understand breaking changes.
Though i was not lucky as this page use deprecated / deleted Types and API.
Also links to Managing Concurrency using Azure Storage - Sample Application points to:
https://code.msdn.microsoft.com/Managing-Concurrency-using-56018114
It does not seems to resolve anything or return a 404

also using the "sample search" i can't find anything anymore regarding Concurrency

And finally it seems that the github repo itself containing sample does not have code sample toward lock/lease and so on.

Personal opinon:
When doing such breaking changes (moving the Lock Api from BlockBlob to Blob and changing a bit the contract,
Having samples seems like a Must and having a Migration guide would be a bonus.
Also having the Concurrency docs page up to date, or at least versionned "v11" and another "v12" might help a bit developers to find what they are looking for.

I probably missed the page somewhere and continue to look for it, but it feel like a feedback was interresting here as the docs is amazing in general for .net since few years now, but as you guessed it needs to be maintained at the same time as the code evolves which is very hard

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: cd5ebd41-40e7-0f94-2090-71151bd0b4f4
• Version Independent ID: 85128309-6794-8ce5-1504-cd31513c80e8
• Content: Managing concurrency - Azure Storage
• Content Source: articles/storage/common/storage-concurrency.md
• Service: storage
• Sub-service: common
• GitHub Login: @tamram
• Microsoft Alias: tamram

[SumanthMarigowda-MSFT]

@tebeco Thanks for your question. We are checking on this and will respond to you soon.

[SumanthMarigowda-MSFT]

@tebeco Firstly, apologies for the delay in responding here and any inconvenience this issue may have caused. Thanks for the feedback! I have assigned the issue to the content author to investigate further and update the document as appropriate.

[tebeco]

Hello again,

As .net5 is going to land (we all hope) in ~6month, we are begining to cross target few repositories to have a small "friction" on release date.
As I understood from
https://github.com/aspnet/Announcements/issues/408
https://github.com/aspnet/Announcements/issues/409
We will have few things to update for our libraries to be fully running on .net 5.

As the docs on https://docs.microsoft.com/en-us/azure/storage/common/storage-concurrency was pointing to an outdated SDK version, It would be amazing to have the same guidance/recomendation over the current version of the SDK (the one that will be compliant with .net5 and that should already be compliant netcoreapp3.1)

That would allow us to do that update in the next days and have time to monitor if it goes well even before .net5

[tebeco]

hello @tamram
I see that lots of documentation topics are moving a lot :D thx a lot for all of that ;)
Do you know if there's a preview branch I can rely on for new API around DistributedLock using Blob ?
Or any new samples (old one seems to be removed from the repo (getting 404)

[tebeco]

hello @tamram @SumanthMarigowda-MSFT
I'm trying to finish few migration for .Net 5.0
do you have any insight on this one ?

[tamram]

@tebeco - I'm working on it. I can't promise when I'll have it done, but hopefully within the next two weeks.

[tebeco]

great news, thx

[tamram]

@tebeco - The examples in the article have been updated for the v12 blob client library.

I opted not to recreate the sample application, because it only included the methods that are now shown in the article.

Let us know if you have further feedback.

please-close

[tebeco]

super good news
thx a lot @tamram