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,042 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 98.10193% with 54 lines in your changes missing coverage. Please review.

Project coverage is 97.03456%. Comparing base (ce6b6c2) to head (1f42ae8).

Additional details and impacted files
@@                 Coverage Diff                  @@
##                main      #12148          +/-   ##
====================================================
+ Coverage   76.14673%   97.03456%   +20.88782%     
====================================================
  Files           3191        1200        -1991     
  Lines         640105      358395      -281710     
  Branches       47233        5592       -41641     
====================================================
- Hits          487419      347767      -139652     
+ Misses        149166        9817      -139349     
+ Partials        3520         811        -2709     
Flag Coverage Δ
Debug 97.03456% <98.10193%> (+20.88782%) ⬆️
integration ?
production ?
test 97.03456% <98.10193%> (+0.00694%) ⬆️
unit ?

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.

LeafShi1 and others added 20 commits November 5, 2024 11:30
* Removing reference to ContextMenuStrip when dispose control

* Merge 'main' to current branch

* Detach ContextMenuStrip from control when executing Dispose

* Use pattern matching for judge variable menu
* Update InitializeComponent() template

* Removing extra namespace
…StripComboBoxFlatComboAdapter (dotnet#12394)

* Add code coverage for ToolStripComboBox.ToolStripComboBoxControl.ToolStripComboBoxFlatComboAdapter

* Handle FeedBacks

* Handle FeedBacks

* Handle FeedBacks

* Fixed the error

* Remove failed test case
* Update dependencies from https://github.com/dotnet/runtime build 20241103.1

Microsoft.Internal.Runtime.WindowsDesktop.Transport , Microsoft.NET.Sdk.IL , Microsoft.NETCore.App.Ref , Microsoft.NETCore.App.Runtime.win-x64 , Microsoft.NETCore.ILAsm , Microsoft.NETCore.ILDAsm , Microsoft.NETCore.Platforms , Microsoft.Win32.Registry.AccessControl , Microsoft.Win32.SystemEvents , runtime.win-x64.Microsoft.NETCore.ILAsm , runtime.win-x86.Microsoft.NETCore.ILAsm , System.CodeDom , System.ComponentModel.Composition , System.ComponentModel.Composition.Registration , System.Configuration.ConfigurationManager , System.Data.Odbc , System.Data.OleDb , System.Diagnostics.EventLog , System.Diagnostics.PerformanceCounter , System.DirectoryServices , System.DirectoryServices.AccountManagement , System.DirectoryServices.Protocols , System.Formats.Nrbf , System.IO.Hashing , System.IO.Packaging , System.IO.Ports , System.Management , System.Reflection.Context , System.Reflection.MetadataLoadContext , System.Resources.Extensions , System.Runtime.Caching , System.Runtime.Serialization.Formatters , System.Security.Cryptography.Pkcs , System.Security.Cryptography.ProtectedData , System.Security.Cryptography.Xml , System.Security.Permissions , System.ServiceModel.Syndication , System.ServiceProcess.ServiceController , System.Speech , System.Text.Encoding.CodePages , System.Text.Encodings.Web , System.Text.Json , System.Threading.AccessControl , System.Windows.Extensions , VS.Redist.Common.NetCore.SharedFramework.x64.10.0
 From Version 10.0.0-alpha.1.24552.2 -> To Version 10.0.0-alpha.1.24553.1

* Update dependencies from https://github.com/dotnet/runtime build 20241104.9

Microsoft.Internal.Runtime.WindowsDesktop.Transport , Microsoft.NET.Sdk.IL , Microsoft.NETCore.App.Ref , Microsoft.NETCore.App.Runtime.win-x64 , Microsoft.NETCore.ILAsm , Microsoft.NETCore.ILDAsm , Microsoft.NETCore.Platforms , Microsoft.Win32.Registry.AccessControl , Microsoft.Win32.SystemEvents , runtime.win-x64.Microsoft.NETCore.ILAsm , runtime.win-x86.Microsoft.NETCore.ILAsm , System.CodeDom , System.ComponentModel.Composition , System.ComponentModel.Composition.Registration , System.Configuration.ConfigurationManager , System.Data.Odbc , System.Data.OleDb , System.Diagnostics.EventLog , System.Diagnostics.PerformanceCounter , System.DirectoryServices , System.DirectoryServices.AccountManagement , System.DirectoryServices.Protocols , System.Formats.Nrbf , System.IO.Hashing , System.IO.Packaging , System.IO.Ports , System.Management , System.Reflection.Context , System.Reflection.MetadataLoadContext , System.Resources.Extensions , System.Runtime.Caching , System.Runtime.Serialization.Formatters , System.Security.Cryptography.Pkcs , System.Security.Cryptography.ProtectedData , System.Security.Cryptography.Xml , System.Security.Permissions , System.ServiceModel.Syndication , System.ServiceProcess.ServiceController , System.Speech , System.Text.Encoding.CodePages , System.Text.Encodings.Web , System.Text.Json , System.Threading.AccessControl , System.Windows.Extensions , VS.Redist.Common.NetCore.SharedFramework.x64.10.0
 From Version 10.0.0-alpha.1.24552.2 -> To Version 10.0.0-alpha.1.24554.9

---------

Co-authored-by: dotnet-maestro[bot] <dotnet-maestro[bot]@users.noreply.github.com>
Update dependencies from https://github.com/dotnet/arcade build 20241104.2

Microsoft.DotNet.Arcade.Sdk , Microsoft.DotNet.CMake.Sdk , Microsoft.DotNet.GenFacades , Microsoft.DotNet.Helix.Sdk , Microsoft.DotNet.RemoteExecutor , Microsoft.DotNet.XUnitExtensions
 From Version 10.0.0-beta.24551.1 -> To Version 10.0.0-beta.24554.2

Co-authored-by: dotnet-maestro[bot] <dotnet-maestro[bot]@users.noreply.github.com>
…dotnet#12418)

Add tests for VB Application Services Exceptions and fix UserTests.UserIdentity to use Auto Properties to stop compiler from giving suggestion.
…' into Shorten-long-inline-comments-Review-4th
…' into Shorten-long-inline-comments-Review-4th
…' into Shorten-long-inline-comments-Review-4th
…' 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