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
Seven lamps Ruskin's Seven Lamps of Architecture provided seven guides, or 'lamps', for the troubled craftsman, guides for anyone who works directly on material things. These seven are: The lamp of sacrifice: The willingness to do something well for its own sake. The lamp of truth: The truth that 'breaks and rents continually'; Ruskin's embrace of difficulty, resistance, and ambiguity. The lamp of power: Tempered power, guided standards other than blind will. The lamp of beauty: Which for Ruskin is found more in the detail, the ornament—hand-sized beauty—than in the large design. The lamp of life: Life equating with struggle and energy, death with deadly perfection. The lamp of memory: The guidance provided by the time before machinery ruled. The lamp of obedience: Obedience to the example set by a master's practice rather than by his particular works; otherwise put, strive to be like Stradivari but do not seek to copy his particular violins. Richard Sennett, The Craftsman 125 Best Architecture Books