Our Story
dotnet-guide.com began in 2004, during the .NET Framework era. From the start, the idea was simple: make .NET concepts easier to understand through practical explanations and examples that developers can explore and adapt.
More than two decades later, the platform has evolved from .NET Framework to .NET Core and modern .NET. Our coverage has evolved with it — from established C# and ASP.NET patterns to cloud-native development, distributed systems, and AI applications built with .NET.
We aim to help both developers learning a topic for the first time and developers maintaining existing applications while evaluating newer approaches.
What You Can Learn Here
Our tutorials cover C#, ASP.NET Core, Blazor, Entity Framework Core, application security, performance, architecture, cloud-native development, and .NET AI. Many guides focus on a specific problem, with explanations of the design choices, relevant code, and links to supporting documentation.
Modernization matters, too. Some articles discuss older .NET versions or migration scenarios, while newer guides focus on .NET 10 and current APIs. We try to identify version-specific requirements so readers can decide whether an example suits their own environment. Historical tutorials may remain available for reference even when their APIs or recommended patterns have changed.
Not every article has the same sample project or verification scope. In our newer, verification-focused tutorials, we document the versions and checks behind the companion code rather than presenting a successful build as proof that a system is production-ready.
Building AI Applications with .NET
Our .NET AI learning hub brings together four published, hands-on tutorials that move from AI provider integration to retrieval, evidence-aware agents, and standardized tool access:
- Provider-Agnostic Chat Gateway: Build a chat API around
Microsoft.Extensions.AIandIChatClient, with provider selection, streaming, and tool-calling patterns. - Hybrid Search with EF Core and pgvector: Combine PostgreSQL keyword search, vector similarity, and Reciprocal Rank Fusion.
- Evidence-First Incident Triage Agent: Explore Microsoft Agent Framework with session-aware interactions, read-only tools, and explicit evidence boundaries.
- Build Your First MCP Server in C# and .NET: Implement a real MCP server and client over
stdiowith three deterministic, read-only tools — without requiring an LLM or API key.
Each of these four tutorials links to a public GitHub companion sample. The guides describe the tested SDK and package baselines, along with the relevant build, test, or integration evidence. Results from hosted AI services can differ by provider, model, and configuration.
How We Create and Review Content
We select topics based on practical developer needs, study official documentation and upstream projects, and prepare examples that illustrate the implementation decisions. We may use AI-assisted tools during research, drafting, and code development, but editorial judgment and responsibility for the published material remain with dotnet-guide.com.
Where a tutorial provides a companion application, we aim to document its framework and dependency versions and the checks actually performed. These may include compilation, automated tests, local protocol or database integration, and — when relevant — live model-provider verification. The precise scope differs between tutorials, so readers should consult each tutorial's evidence and repository rather than assume every sample has undergone the same tests.
We revisit content when needed, but older articles may not always reflect the newest releases. We welcome reports of mistakes, outdated examples, and broken links through our contact page. For more information on our standards and AI-assisted workflows, read our Editorial Policy.
Independent and Reader-Focused
Independence Notice: dotnet-guide.com is an independent educational resource. We are not affiliated with, sponsored by, or endorsed by Microsoft Corporation. Microsoft, .NET, C#, ASP.NET, Visual Studio, and other third-party names are referenced to identify the technologies discussed. Trademarks remain the property of their respective owners.
The website is independently operated, and its tutorials and articles are published under the dotnet-guide.com brand. Display advertising, including Google AdSense, helps support the site; advertising relationships do not determine our technical recommendations or tutorial conclusions.
Our content is educational, not a substitute for a security assessment or production review. See our Disclaimer for limitations on the use of code examples, and our Privacy Policy for information about website data practices.
Frequently Asked Questions
Who runs dotnet-guide.com?
dotnet-guide.com is an independently operated educational publication. Its content is published under the site brand, with editorial review focused on clarity, technical accuracy, and practical value.
How can I suggest a fix or a new topic?
Use our contact page and include the relevant tutorial URL, framework or package version, and a short description of your suggestion. We review feedback when possible but cannot promise a specific response time.
Where can I find the .NET AI examples and source code?
Start with the .NET AI learning hub for the four live guides. Each links to its associated GitHub sample, where you can examine the source code and documented verification work.
Do you offer consulting or custom development?
The website focuses on publishing educational tutorials and articles rather than providing project-specific development or consulting services.
Why do some tutorials have .NET version labels?
Framework and package APIs change over time. Version labels and implementation notes help explain which baseline an example targets. Older tutorials may remain online as historical references and should be checked against current documentation before reuse.