|
|
|
|
|
by mihaaly
271 days ago
|
|
> Searching in chat channel for a specific problem is not a good way to handle documentation I just wanted to highlight this. I am so happy seeing this written down explicitly and finally. Throughout the years I struggled so much finding relevant and accurate information about a feature of a product because it was scattered in chat channels, inadequate for providing reliable data (out of date or uncertain staleness, evolving or straight up wrong suggestions found, tangential only, patial, ...). Big names do it (Unity3D, DevExpress, ...). To make the matter worst both official support personel and power users promote its use, defend its use against critique to the last blood, despite of the obvious shortcomings and unreliability for average users. It is just the lazy excuse of providing the necessary knowledge. |
|
So why don't all of these people simply write it down in a notion/document store and meticulously keep it all up to date?
Because the business does not want that. We demand efficiency, so we understaff engineering departments sufficiently that there is always a little crunch, so that slightly-too-few engineers have to work slightly-harder-than-they-want to make the business successful. The end result of this intentionally engineered "lack of time" is that things like maintaining meticulous documentation are ignored, and the only time the knowledge is shared is in a frantic slack message.
The business is designed to do this. It's not laziness. It's the standard operating procedure to increase efficiency and profit.