I find this answer amongst my colleagues comes from the simple fact that they consider documentation a chore, and are deadly afraid that once someone starts documenting, they may have to document as well. And these same colleagues are deadly afraid of making anything remotely related to the front end, beyond churning out an API and leaving me to figure out the proper syntax from their PHP controllers.
Yes, I document their APIs in Confluence. It gets them off of their asses because then they feel compelled to correct me.
Right. Because documentation and comments can lie and software can’t. I can’t tell you how many times I’ve been burned by documentation which wasn’t updated after software changes, or even after the project was “completed”.
This highlights how Apple’s approach creates safety hazards. Because they refuse to sell OEM batteries direct to customers and prevent affordable legitimate repair shops from servicing Apple devices, a lot of people end up taking their phones to back-room operations which use questionable materials that might explode.