I suggest you ...

Code definition window and "Implement Interface" feature should include full XML documentation

When implementing an interface, the "Implement Interface" context menu does not insert the associated XML documentation.

It should, since that XML documentation is usually a good starting point. Consider perhaps adding a TODO tag.

The same should apply to abstract class implementation.

The alternative, copying the contents of the Code Definition window into your code, saves a lot of (re)typing. Unfortunately, the documentation does not include the XML documentation tags, which must be added by hand.

An example from the code def. window:

// Summary: <-- should be <summary>
// Performs application-defined tasks associated with freeing,
// releasing, or resetting unmanaged resources.
// <-- missing </summary>.
void Dispose();

It also looks like the documentation is not complete - is the exception documentation missing??

4 votes
Vote
Sign in
Check!
(thinking…)
Reset
or sign in with
  • facebook
  • google
    Password icon
    I agree to the terms of service
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    CSharpJohnCSharpJohn shared this idea  ·   ·  Flag idea as inappropriate…  ·  Admin →

    0 comments

    Sign in
    Check!
    (thinking…)
    Reset
    or sign in with
    • facebook
    • google
      Password icon
      I agree to the terms of service
      Signed in as (Sign out)
      Submitting...

      Feedback and Knowledge Base