DevOps

Wikiexport 0.3

Paul Hatcher
Posted in DevOps, Azure
Just pushed a new version of WikiExport with a couple of useful features Change titleFormat to have explicit {project}/{title} macros Support for .attachments in non-root folder - provided by @ricfre The first is just a simplification since it’s more intentional to use named values rather than {0} etc, and we can also automatically determine projectInTitle from the titleFormat. The second one allows support for code wikis and the image path not being in the root of the repository e.

Project Documentation from Azure DevOps Wikis

Paul Hatcher
Posted in DevOps, Azure
One perennial issue when developing software is how to keep documentation up to date. For detailed documentation such as APIs this has become a lot easier in recent years with capabilities such as Swashbuckle being able to pick up annotations directly from the code. The principal of keeping your documentation as close to the code as possible means that development teams are more likely to keep it up to date and relevant to the actual behaviour - presuming you are have a good definition of done and are performing code reviews 😉.

Quality Myths

Paul Hatcher
Posted in DevEnv, DevOps, Testing
Microsoft has published the results of some empirical studies about how development practices affect quality Test Driven Development improves quality by 60 to 90 percent but takes 15 to 35 percent more ‘up front’ time. The time spent is compensated by savings in maintenance time later on. Team & organization structure has a huge impact on quality. Although this is conventional wisdom the study publishes figures to prove this. The metrics used data such as how many engineers are involved in a project, how many times individual source files were modified.