[idclip]

I would skip:

   1. introducing IaC, 
   2. and the OOP/functiobal bits

This stuff really just repeats itself everywhere.

I would: directly put my method in an RFC style

   1. „this is what this is (jpg here, maybe two comparison graphics. Of old arch, and yours), 
   2. and here how it works. 

I did find the pet/catle metaphor great. im not against prose.

[tinodelletna]

This is really great feedback! Thanks, we will definitely take this into account when writing more technical documentation.