Use your source code to document your application - Michaël Hompus - NDC Oslo 2024

This talk was recorded at NDC Oslo in Oslo, Norway. #ndcoslo #ndcconferences #developer #softwaredeveloper Attend the next NDC conference near you: https://ndcconferences.com https://ndcoslo.com/ Subscribe to our YouTube channel and learn every day: / @NDC Follow our Social Media! https://www.facebook.com/ndcconferences https://twitter.com/NDC_Conferences https://www.instagram.com/ndc_conferences/ #dotnet #tools #roslyn #code For many development teams, writing and updating documentation can feel like a chore, especially when the codebase changes frequently. While developers often consider the source code as its own documentation, this perspective might not resonate with all stakeholders. Moreover, the source code might not adequately illustrate how different components interact. What if we could transform our source code into comprehensive documentation that benefits both the team and stakeholders? In this session, we will explore how to leverage Roslyn to generate documentation directly from your .NET source code. We'll delve into creating diagrams that depict the structure and relationships within an aggregate and sequence diagrams that illustrate the flow throughout the application. We'll render these using file formats such as PlantUML, Mermaid, Markdown, and AsciiDoc. By the end of this session, you'll be equipped to let your source code articulate the operation of your application in a format that is accessible and meaningful to your team and stakeholders. Key Takeaways: * Learn how to use Roslyn to interpret your source code. * Understand how to create and render diagrams that depict the structure and flow of your application.