Dotnet-api-docs: Add note, that Calendar.GetWeekOfYear differs from ISO 8601 week of year

[kapsiR]

Affected docs: /xml/System.Globalization/Calendar.xml

Hints:

• Workaround for .NET Framework:
  https://docs.microsoft.com/en-us/archive/blogs/shawnste/iso-8601-week-of-year-format-in-microsoft-net
• Solution from .NET Standard 2.1 onwards (>= .NET Core 3.0)
  ISOWeek class
  https://docs.microsoft.com/en-us/dotnet/api/system.globalization.isoweek

[kapsiR]

I found out, that this is already in /xml/System.Globalization/CalendarWeekRule.xml...
But the referenced blog entry link is broken: https://go.microsoft.com/fwlink/?LinkId=160851

[rohansp]

@kapsiR @mairaw Is this already resolved or can I work on this issue? Do we need to correct the link in CalendarWeekRule.xml What about Calendar.xml?

[kapsiR]

The broken link in /xml/System.Globalization/CalendarWeekRule.xml has been fixed.

Nevertheless I would prefer that the remarks of Calendar.GetWeekOfYear in /xml/System.Globalization/Calendar.xml would be updated accordingly too.

@mairaw Would be cool if @rohansp can update the Remarks section of Calendar.GetWeekOfYear to have this information there too?

[carlossanlop]

@tarekgh can you please help triage?

[tarekgh]

The comment needed to be added looks reasonable to me. @kapsiR do you want open a PR for it?

[kapsiR]

@tarekgh Yes I can submit a PR for this, but if @rohansp wants to try it he can do it too

[rohansp]

@kapsiR go ahead.

[carlossanlop]

Thank you for offering your help, @kapsiR. Let us know if you need any help with creating PRs in dotnet-api-docs.
You don't need to build anything locally to verify your changes, you can let the CI in the PR give you the results.
Please add me and Tarek as reviewers.