cantis

Remote Development Notes

Codespaces provides a cloud based version of VSCode that is attached to a github repository. The environment can be configured to allow you to run your code online.

Codespaces Overview

https://docs.github.com/en/codespaces/overview

Live Share

https://learn.microsoft.com/en-us/visualstudio/liveshare/use/share-project-join-session-visual-studio-code

cantis

API Documentation: Generation from XML Comments

Note: This applies to .net 6 LTS

1. Turn on XML Documentation generation in the project in Properties-Build-Output select Documentation File
2. Modify the AddSwaggerGen line in the program.cs file

builder.Services.AddSwaggerGen( c =>
    c.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory,
        $"{Assembly.GetExecutingAssembly().GetName().Name}.xml")));