Michaël Hompus

Information & Communications Technology

Azure Functions Azure PaaS Office 365 Azure Security Machine Learning Bot Framework Application LIfecycle Management Azure Key Vault C# Dynamics 365 Azure CosmosDB Software Architecture Dapr Architecture ML.NET Azure Custom Vision Azure Cognitive Services Azure DevOps Azure .NET ASP.NET Roslyn microservices Azure Cost Optimization

Nijmegen, Gelderland, Netherlands

Use your source code to document your application

As a development team, writing documentation is often not our favorite activity. And keeping it up to date after every code change is a bigger challenge. Developers claim that the source code is the documentation itself, but do your stakeholders agree, do they actually read the code? And does it show how the parts are working together?

What if our source code would be the source of our documentation, for the team and our stakeholders?

In this session we will see how we can utilize Roslyn to generate documentation. Like creating diagrams that display the structure and relationships within an aggregate, or a sequence diagram that displays the flow throughout the application. We will render this using file formats such as PlantUML, Markdown and AsciiDoc.

After this session you will be able to let your source code speak in forms that your team and your stakeholders explain to the operation of your application.

Length: preferable 45-70 mins
Audience: dotnet, c# background helps, not required
Keywords: Documentation, Roslyn, dotnet, C#, DDD


Michaël Hompus

Software Architect | Microsoft MVP

Michaël Hompus is a Software Architect at Info Support.
As Software Architect he is part of several teams, realizing new and innovative solutions, preferable using the Microsoft Cloud.
Michaël has many years of development experience with .NET, Microsoft Azure, Azure DevOps, Office 365 and Dynamics 365.
His passion is to share knowledge, with colleagues, customers, and peers.
Microsoft has recognized his efforts for the community by awarding him a Microsoft MVP award.

  instagram.com/energy164 (Instagram)
  blog.hompus.nl (blog)
  infosupport.com (company)
  youtube.com/playlist (YouTube - past sessions)

Michaël's full speaker profile