Introduction Swagger is a way to document a REST API, and tools can automate much of this process (but not all of it). At the centre of things is a JSON file that describes the API. You can create this file by hand or use a tool to generate e.g. from the API source code. … Continue reading Documenting ASP.NET REST APIs with Swagger / Swashbuckle
Category: Documentation
Writing documentation can be in your own interests
Introduction Some people take the agile manifesto's ... We ... value ... working software over comprehensive documentation the wrong way. They think it means We don't value documentation This is: a) not the same as what the agile manifesto says; b) wrong, even if you act purely from self-interest. There are at least two selfish … Continue reading Writing documentation can be in your own interests
Trying to not get too ranty about documenting software architecture
This article is my thoughts on a video about documenting software architecture: https://www.youtube.com/watch?v=kv8XedJTEww A summary of the video is: Domains other than software architecture, e.g. maps or electrical circuits, do a good job of capturing useful and important information in a way that communicates this well – this is mostly in pictures. Software architecture does … Continue reading Trying to not get too ranty about documenting software architecture
Random Tech Thoughts 