Skip to content
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

Improve xml comments review 5th DRAFT #12148

Draft
wants to merge 1,002 commits into
base: main
Choose a base branch
from

Conversation

paul1956
Copy link
Contributor

@paul1956 paul1956 commented Sep 15, 2024

Addresses improved XML comment in #11984

Proposed changes

  • Add and improve XML comments in VB code

Customer Impact

  • Improve WinForms Design experience

Regression?

  • No

Risk

  • None - no code changes
Microsoft Reviewers: Open in CodeFlow

@paul1956 paul1956 requested a review from a team as a code owner September 15, 2024 23:33
@paul1956 paul1956 changed the title Improve xml comments review 6th draft Improve xml comments review 6th DRAFT Sep 15, 2024
Copy link

codecov bot commented Sep 16, 2024

Codecov Report

Attention: Patch coverage is 91.95608% with 315 lines in your changes missing coverage. Please review.

Project coverage is 76.22662%. Comparing base (084e6d0) to head (e0b0e0c).

Additional details and impacted files
@@                 Coverage Diff                 @@
##                main      #12148         +/-   ##
===================================================
+ Coverage   76.03186%   76.22662%   +0.19476%     
===================================================
  Files           3181        3189          +8     
  Lines         639670      643152       +3482     
  Branches       47215       47459        +244     
===================================================
+ Hits          486353      490253       +3900     
+ Misses        149797      149368        -429     
- Partials        3520        3531         +11     
Flag Coverage Δ
Debug 76.22662% <91.95608%> (+0.19476%) ⬆️
integration 18.11870% <6.81382%> (-0.05758%) ⬇️
production 50.10485% <75.02392%> (+0.28286%) ⬆️
test 97.03506% <98.11912%> (+0.00591%) ⬆️
unit 47.35068% <69.47368%> (+0.30777%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

@Tanya-Solyanik Tanya-Solyanik added the draft draft PR label Sep 18, 2024
@Tanya-Solyanik Tanya-Solyanik marked this pull request as draft September 18, 2024 01:50
@paul1956 paul1956 changed the title Improve xml comments review 6th DRAFT Improve xml comments review 5th DRAFT Sep 19, 2024
''' <exception cref="NotSupportedException">A folder name in the path contains a colon (:) or is in an invalid format.</exception>
''' <exception cref="SecurityException">The user lacks necessary permissions to view the path.</exception>
''' <exception cref="UnauthorizedAccessException">A destination file exists but cannot be accessed.</exception>
Public Sub CopyDirectory(sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps this comment can reference docs for the SYstem.IO API via the inheritdocs tag?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Tanya-Solyanik i can fix comment but this is not ready to be reviewed (it should be DRAFT) as it includes all the other small PR’s not yet merged.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Tanya-Solyanik

I have updated the VB Runtime Proxy Comments to use inheritdoc cref=""
Sometimes I could point to System.IO other files I had to point to FileIO.FileSystem because VB is not always a thin layer over System.IO, in some causes Sub and Function are swapped, return types are different or System.IO does not have all the overloads that VB has plus other similar reasons. The complexity/size of the files has been drastically simplified.

This is still not ready to review.

…' into Shorten-long-inline-comments-Review-4th
Fix Upload logic to handle Web error 500
…' into Shorten-long-inline-comments-Review-4th
…' into Shorten-long-inline-comments-Review-4th
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
draft draft PR
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants