Skip to main content

Not creating documentation is a techie curse

Techies are cursed by the reluctance to create documentation. Most environments are a SOP (Standard Operating Procedures) desert. In every job in which I have started, no-one has ever given me a SOP of the services being provided. I would have to "sink or swim." Most techie managers who were treated in this manner, reinforce the behaviour by treating their subordinates in a similar manner. In reality they even go further to ridicule those who create documentation as bureaucratic. By this they imply that it is a waste of time but often the underlying reason is to be able to be a hero, as when the sh1t hits the fan, they are the only ones able to resolve it, as all the knowledge is in their heads and not on paper for anyone else to attempt to resolve.

This article was originally published over on LinkedIn: Not creating documentation is a techie curse



How google does documentation

Comments

Popular posts from this blog

easywall - Web interface for easy use of the IPTables firewall on Linux systems written in Python3.

Firewalls are becoming increasingly important in today’s world. Hackers and automated scripts are constantly trying to invade your system and use it for Bitcoin mining, botnets or other things. To prevent these attacks, you can use a firewall on your system. IPTables is the strongest firewall in Linux because it can filter packets in the kernel before they reach the application. Using IPTables is not very easy for Linux beginners. We have created easywall - the simple IPTables web interface . The focus of the software is on easy installation and use. Access this neat software over on github: easywall

No Scrubs: The Architecture That Made Unmetered Mitigation Possible

When building a DDoS mitigation service it’s incredibly tempting to think that the solution is scrubbing centers or scrubbing servers. I, too, thought that was a good idea in the beginning, but experience has shown that there are serious pitfalls to this approach. Read the post of at Cloudflare's blog: N o Scrubs: The Architecture That Made Unmetered Mitigation Possible

Should You Buy A UniFi Dream Machine, USG, USG Pro, or Dream Machine Pro?