This is a C#/.NET and AI-focused repository. It contains practical lessons, code samples, and integrations for building Generative AI applications in .NET, including Azure OpenAI, local models, and more. Please follow these guidelines when contributing:
- Run
dotnet format
before committing any changes to ensure proper C# code formatting and style - Ensure all code builds and passes tests locally with
dotnet build
anddotnet test
- Build:
dotnet build
- Test:
dotnet test
- Format:
dotnet format
- Lint (if enabled):
dotnet format --verify-no-changes
- For samples using other tools (e.g., Python, Docker), follow instructions in the relevant lesson's
readme.md
01-IntroToGenAI/
,02-SetupDevEnvironment/
, etc.: Lesson folders with code, images, and documentationsrc/
: Source code for practical samples and lesson demosimages/
: Course and lesson imagesdocs/
: Additional documentation and guidestranslations/
: Translated course materials
- Follow C# and .NET best practices (naming, async/await, nullability, etc.)
- Use modern .NET features (e.g., top-level statements, nullable reference types) where appropriate
- Maintain existing code structure and organization—place new samples in the correct lesson folder
- Write unit tests for new functionality when possible (use xUnit or MSTest)
- Document public APIs, sample usage, and complex logic. Update lesson
readme.md
files as needed - For AI integrations (Azure OpenAI, Ollama, etc.), follow official SDK and security guidelines
- Prefer dependency injection and configuration via
appsettings.json
for new .NET projects - Keep code and documentation accessible for beginners—add comments and links to docs where helpful