dotnet / docs

This repository contains .NET Documentation.
https://learn.microsoft.com/dotnet
Creative Commons Attribution 4.0 International
4.29k stars 5.92k forks source link

no good comapre to the previous version. difficult to follow. specially the code #33998

Open MaliTaba opened 1 year ago

MaliTaba commented 1 year ago

[Enter feedback here] the previous version was better


Document Details

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

BillWagner commented 1 year ago

Hi @MaliTaba

Were you looking for this article?

If so, I'd like to learn what you liked better about that article. Both articles have had good reviews.

We didn't remove any of the previous articles. We rearranged them and made sure that all the async content was in one place. I'd also like to know how you got to this article. If one of our links should be updated, that's another possible fix.

MaliTaba commented 1 year ago

Hi @BillWagner Yes, I am looking for the article you linked, Thanks for sharing. I was reading it a few days ago and it was in my bookmark list and when I came back to use it as a reference for a point I was making, the content changed. I searched the article with title, your name as author and last update date of March 11,2022 but I constantly was directed to the latest version.

Here is why I like the other version better

I understand this is a very personal view but I hope I could explain why I thought the previous version was better. My frustration was more that I could not find it and it seems this replaced that content. Perhaps, next to one another, each satisfies a certain audience. Maybe a link to the previous version could be helpful (if there was, I missed it).

As for your question of " I'd also like to know how you got to this article". If by this article you mean the new one that was updated yesterday, google search on Microsoft asynchronous took me there.

Thank you for your hard work in writing these articles. These are complicated subjects and I see your effort to make them simple and easier to understand.

Finally, sorry for my sharp review last night. I was in the middle of my research and I lost the reference. Being tired did not help. Also did not think anyone actually checks and cares about the feedback.

Thank you

BillWagner commented 1 year ago

Thanks @MaliTaba

Those are great suggestions. I'll leave this as an enhancement for when I next update this section.