So much knowledge not being applied Most organisations have a lot of documents and data floating around that hardly ever gets revisited or used. They all have research, reading, and relevant information collecting dust. Stuff that should be informing the decisions and strategies of the company. Some of it sits unread in a knowledge base or a wiki. Some of it lies in the drives of individual employees who don’t have a way to share it productively. So much knowledge not being applied! Except that’s not how we work as human beings. If you haven’t read it, experienced it, and contextualised it, then it isn’t knowledge to you. Knowledge is a quality that people possess, not documents, and the only way to transfer it from one place to another is for people at both ends to apply themselves and make it their own. Baldur Bjarnason, On online collaboration and our obligations as makers of software knowledgedocumentationwork
Dependence is more profitable than education A customer who pays—in advance—for service contracts is a more stable income source than a customer who has fully mastered a product's use. Customer dependence is more profitable than customer education. What I find truly baffling are manuals—hundreds of pages long—that accompany software applications, programming languages, and operating systems. Unmistakably, they signal both a contorted design that lacks clear concepts and an intent to hook customers. Niklaus Wirth, A Plea for Lean Software The design concept documentation
Scraps of the brocade of autumn There is a story of Rikyu which well illustrates the ideas of cleanliness entertained by the tea masters. Rikyu was watching his son Shoan as he swept and watered the garden path. "Not clean enough," said Rikyu, when Shoan had finished his task, and bade him try again. After a weary hour the son turned to Rikyu: "Father, there is nothing more to be done. The steps have been washed for the third time, the stone lanterns and the trees are well sprinkled with water, moss and lichens are shining with a fresh verdure; not a twig, not a leaf have I left on the ground" "Young fool," chided the tea master, "that is not the way a garden path should be swept. "Saying this, Rikyu stepped into the garden, shook a tree and scattered over the garden gold and crimson leaves, scraps of the brocade of autumn! What Rikvu demanded was not cleanliness alone, but the beautiful and the natural also. Okakura Kakuzō, The Book of Tea In a state of reverberation wabi-sabi