Not related to this specific case or coding but about bad practices in documentation in general in my previous job I had huge headaches with some bad practices

Not related to this specific case or coding but about bad practices in documentation in general in my previous job I had huge headaches with some bad practices described in Microsoft's Active Directory training material. That company forest domain ended in .local because the AD admin was a MS MVP through and through. https://en.wikipedia.org/wiki/.local#Microsoft_recommendations https://en.wikipedia.org/wiki/.local#Microsoft_recommendatio... However retail stores were almost entirely composed of Linux machines except for the manager's desktop. The corporate software used in these Linux machines would always pull samba which in turn pulled avahi. As soon as the software was installed post imaging because of licensing requirements connectivity with central servers was interrupted and the person installing it (which was always a different person because the stores were spread through the country) will often scratch their head, specially those who don't bother to read notes.