Take Advantage of XML Comments: Listing 1

<?xml version="1.0" encoding="utf-8" ?>
<XMLDocCommentSchema>

<CodeElement type="Class">
    <Template>
        <summary />
        <remarks />
    </Template>
    <CompletionList>
        <include file="" path="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Declare">
    <Template>
		<summary />
		<param />
		<returns />
		<remarks />
    </Template>
    <CompletionList>
		<exception cref="" />
		<include file="" path="" />
		<param name="" />
		<permission cref="" />
		<remarks />
		<returns />
		<summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Delegate">
    <Template>
		<summary />
		<param />
		<returns />
		<remarks />
    </Template>
	<CompletionList>
	    <include file="" path="" />
	    <param name="" />
	    <permission cref="" />
	    <remarks />
	    <returns />
	    <summary />
	</CompletionList>
</CodeElement>

<CodeElement type="Enum">
    <Template>
        <summary />
        <remarks />
    </Template>
    <CompletionList>
        <include file="" path="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Event">
    <Template>
		<summary />
		<param />
		<remarks />
		</Template>
	<CompletionList>
	    <include file="" path="" />
	    <param name="" />
	    <permission cref="" />
	    <remarks />
	    <summary />
	</CompletionList>
</CodeElement>

<CodeElement type="Field">
    <Template>
        <summary />
		<remarks />
	</Template>
	    <CompletionList>
	    <include file="" path="" />
	    <permission cref="" />
	    <remarks />
	    <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Function">
    <Template>
		<summary />
		<param />
		<returns />
		<remarks />
    </Template>
    <CompletionList>
		<exception cref="" />
		<include file="" path="" />
		<param name="" />
		<permission cref="" />
		<remarks />
		<returns />
		<summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Interface">
    <Template>
        <summary />
        <remarks />
    </Template>
    <CompletionList>
        <include file="" path="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Module">
    <Template>
        <summary />
        <remarks />
    </Template>
    <CompletionList>
        <include file="" path="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Operator">
    <Template>
		<summary />
		<param />
		<returns />
		<remarks />
	</Template>
    <CompletionList>
		<exception cref="" />
		<include file="" path="" />
		<param name="" />
		<permission cref="" />
		<remarks />
		<returns />
		<summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Property">
    <Template>
        <summary />
        <param />
        <value />
        <remarks />
    </Template>
    <CompletionList>
        <exception cref="" />
        <include file="" path="" />
        <param name="" />
        <permission cref="" />
        <remarks />
        <summary />
        <value />
    </CompletionList>
</CodeElement>

<CodeElement type="Structure">
    <Template>
		<summary />
		<remarks />
    </Template>
    <CompletionList>
        <include file="" path="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Sub">
    <Template>
        <summary />
        <param />
        <remarks />
    </Template>
    <CompletionList>
        <exception cref="" />
        <include file="" path="" />
        <param name="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

  <ChildCompletionList> 
    <c/> 
    <code/> 
    <example/> 
    <list type=""> 
		<description/>
		<item>
			<description/>
			<term/>
		</item>
		<listheader> 
			<term/> 
			<description/> 
		</listheader> 
		<term/> 
    </list> 
    <para/> 
    <paramref name=""/> 
    <see cref=""/> 
    <seealso cref=""/> 
  </ChildCompletionList>

</XMLDocCommentSchema>

About the Author

Joe Kunk is a Microsoft MVP in Visual Basic, three-time president of the Greater Lansing User Group for .NET, and developer for Dart Container Corporation of Mason, Michigan. He's been developing software for over 30 years and has worked in the education, government, financial and manufacturing industries. Kunk's co-authored the book "Professional DevExpress ASP.NET Controls" (Wrox Programmer to Programmer, 2009). He can be reached via email at [email protected].

comments powered by Disqus

Featured

  • VS Code 1.123 Adds Agent Session Sync, 1M Context Windows

    Microsoft released Visual Studio Code 1.123 on June 3, adding agent-focused features, larger model context support, integrated browser updates and a new delay for some automatic extension updates.

  • Copilot Billing Shock Hits Developers

    Developer complaints about GitHub Copilot's new usage-based billing model have centered on unexpectedly rapid AI credit consumption, and neither GitHub nor Microsoft has responded directly to the backlash, though they have previously published guidance to lessen model usage costs.

  • Hands On with GitHub Copilot App Technical Preview: Turning a Blazor Issue into a PR

    GitHub's brand-new Copilot desktop app, in technical preview, handled a small Blazor issue from planning through pull request creation, but the hands-on test also showed why developers still need to verify agent work in the running app before merging.

  • At Build 2026, Microsoft Sets Up Windows as an OS for AI Agents

    Microsoft's Build 2026 Windows developer announcements point to a broader platform strategy for agentic AI, spanning terminal workflows, local models, app-building skills, Cloud PCs and operating system-level containment.

Subscribe on YouTube