Posts

Introduction At work, we have a central configuration build, that we pick parts and pieces from for our ‘deployments’. As you can read in my resume I am working as a Virtualisation Engineer. There I am building most of the deployment code. Our base structure looks at our vCenters as primary key. What does that mean? Well, if you take a vCenter as main key, then everything that builds a vCenter (ESXi hosts, clusters, distributed switches, storage, etc.) are parts under the vCenter configuration. So you target a vCenter and not specifically the hosts underneath a vCenter. ...

Introduction In my previous article, I was writing about Mermaid and that I wanted to experiment with generating documentation from the actual sources. I was recently able to focus properly on this and I think I had a blast breakthrough at least for myself. The state now Last time I wrote that I was still investigating how and what, especially because of the compression that takes place when you do a graph TopDown(TD). There is a very simple solution to that, make it Left to Right! ...

Introduction In a previous article, I wrote something about Azure Devops and how I see it. I also wanted to play with automated documentation generation, which basically means that I am considering a template, and get bits and pieces from a configuration that I also use to deploy stuff, into a markdown file and present that on a ‘host’. One of the things that ‘annoyed’ me is that documentation always lags behind. Why? Because you need to modify it to remain relevant. See it is an instruction manual for your car, as long as the car itself remains the same, the manual remains relevant. But if you lets say, change the navigation unit in it, you either need to write a new part for that in the documentation (and add it as addendum or something), or reprint the instructions, else it will not fit anymore. ...