News for hackers. Stuff that matters.
Re:Technical debt as a lack of understanding by amscanne on Friday November 06, 2020 @02:39PM (#25010458)
This is a good parable, but a bad metaphor: no one would open a staffed lending library with a collection so small that the staff could keep everything in their head. The key to a good metaphor is that it should hit something familiar and normal, so that the listener can devote their mental cycles only to the relevant understanding.
Re:Technical debt as a lack of understanding by westoncb on Friday November 06, 2020 @06:11PM (#25012010)
There are really two properties which are essential for a metaphor to convey understanding (which is not to say no other aspects have an effect—they certainly do, but I'm just trying to narrow down the 'functional core' here):

1. It needs to be expressed in the terms of a subject already understood by the listener.

2. It should have a 'structure' which is similar to that of the new, not yet understood subject.

These two things allow an identification to be made between something already understood and something not yet understood, granting new understanding.

The idea that the library should be 'normal' is not essential; it just needs to be understandable. (granted if it became too unusual it could cause problems, but I'll just leave it up to the reader's judgement whether "a library with 25 books" is too large a stretch of the imagination)

What's really nice about the above metaphor is that its structure matches the situation with coding very closely: technical debt is about the up front time-cost of introducing new systems of organization to replace ad-hoc, unsystematic methods whose cost-effectiveness decreases as project complexity (to put it loosely) increases.

While this is a pretty abstract notion in itself, the library scenario captures the same key points and dynamics in a way that's comprehensible to anyone with an understanding that libraries use 'systems of organization' (even if they don't know an abstract term for it)—this still works even if the particular set up for the 'library' in the example would not be found in the real world.

Re:Technical debt as a lack of understanding by amscanne on Friday November 06, 2020 @06:44PM (#25012166)
We’ll have to agree to disagree. I think a metaphor that has nothing to do with reality causes people to think too much about it. You end up replacing one abstract thing with another abstract thing (and the reason to go metaphoric in the first place is to make the concept less abstract). The metaphor makes more sense you because you’re already deeply familiar with the concept of technical debt so you’re able to easily evaluate (2) — you’re not actually using it for understanding. If I told this metaphor to my spouse (for whom I’m often using metaphors to explain things), the reaction would be: “What are you talking about? Library with 25 books? Huh?”
Re:Technical debt as a lack of understanding by westoncb on Friday November 06, 2020 @07:11PM (#25012311)
> (and the reason to go metaphoric in the first place is to make the concept less abstract)

I completely agree with you there. But I disagree that the unusual library example is more abstract.

As a point of contrast, I gave an abstract account of technical debt for the purpose of comparison to the more concrete library metaphor (to show that the abstract account would be more difficult for many):

> technical debt is about the up front time-cost of introducing new systems of organization to replace ad-hoc, unsystematic methods whose cost-effectiveness decreases as project complexity (to put it loosely) increases.

A library with 25 books is not more abstract, though it is a hypothetical concrete thing [1]. If someone has difficulty with hypothetical concrete things, that could certainly make using metaphors with them more difficult—and I can see why you would add additional constraints onto what makes a good metaphor. In my personal experience, saying, "imagine a library, but with only 25 books, which is run by a single person," would be not asking too much of an audience. But I see your point that some may struggle with it.

[1] There is a handy way of considering this distinction: becoming more abstract involves making some 'parameter,' which was fixed, free instead: so for instance a more abstract notion than any particular library is: a manager of a collection of objects which are loaned out to people for limited durations of time. In that example, we free the parameter 'book' so that it isn't set to anything specific. If we instead say, "a library but for CDs instead of books," it's equally concrete since we haven't freed any parameters, we just replaced one concrete value for another. That's what happened in the "library with 25 books" example, which is why I say it is not more abstract.

Re:Technical debt as a lack of understanding by acoard on Monday November 09, 2020 @01:05PM (#25037604)
>2. It should have a 'structure' which is similar to that of the new, not yet understood subject.

If you'll forgive my pedantry, at this point you're not discussing metaphors and have veered into analogies. Maybe we can meet in the middle and call these metaphorical analogies? ;)

Metaphors are when you say something is something it is not ("my wife's smile is the bright sun I wake up to"). There need not be anything unfamiliar with a metaphor or any explanatory power behind a metaphor. Analogies are when you explain or frame a concept using an already understood concept ("the car is out of gas, like when you're out of energy and don't want to run around.")

As an aside, I'll mention that the idea that "analogy as the core of cognition"[0] has been kicking around in academia for years, and comes from Douglas Hoffstader (author of Gödel, Escher, Bach).

[0] http://worrydream.com/refs/Hofstadter%20-%20Analogy%20as%20t...

Re:Technical debt as a lack of understanding by westoncb on Tuesday November 10, 2020 @12:58AM (#25043172)
> There need not be anything unfamiliar with a metaphor or any explanatory power behind a metaphor

The purpose is still explanatory, it's just possible for the explanation to be in terms of perceptions rather than structure: in your example with wife/bright sun the purpose is still to make an identification between two domains, one familiar, one not ("bright sun" is familiar to the reader; author's wife is not), but rather than the two being "structurally similar" it's that they evoke similar experiences in the author, and the author is able to explain their experience by sharing this identification.

That said, I agree with you that what I was discussing is closer to definitions of analogy in certain areas of cognitive science (e.g. Hofstadter's work, like you've pointed out—or John Sowa's: http://www.jfsowa.com/logic/theories.htm)

But the original example with the library would've been better termed an analogy to begin with, rather than a metaphor—I just adopted the previous commenter's terminology :) (though admittedly I'm more inclined to interchange the two fluidly because I don't find the differences essential: I would just call the kind of metaphor you used a perceptual analogy. Maybe I am missing something important about metaphor though—I'd be curious to hear if so!)

Re:Technical debt as a lack of understanding by kortilla on Friday November 06, 2020 @07:11PM (#25012306)
If your metaphor becomes detached from reality people focus too much on the side that’s supposed to be familiar.
Re:Technical debt as a lack of understanding by Talanes on Friday November 06, 2020 @03:23PM (#25010779)
If you're being that pedantic about your metaphors, I don't think a good metaphor exists.
Re:Technical debt as a lack of understanding by justanotherc on Friday November 06, 2020 @05:25PM (#25011735)
I tend to agree with him. It takes too long to tell that story. In a boardroom meeting type environment people don't have time or the attention span to settle in for story time. You need to be able to illustrate your point in 3 sentences or less.
Re:Technical debt as a lack of understanding by White_Wolf on Friday November 06, 2020 @08:00PM (#25012509)
Whenever I had to explain it to management I tell them something along the lines of: When was the last time you clean your office cupboard? If anyone else from management needs to find something in there without your help how long would it take compared to you? It's the same with our scripts. They need cleaning up and documenting in case one of us decided to call it a day.

Edit: When the situation allows(tbh I rarely miss a chance) I follow up with: You have to thank our sales guys making unrealistic promises for our lack of documentation.

Re:Technical debt as a lack of understanding by c22 on Friday November 06, 2020 @05:47PM (#25011859)
Thus, "technical debt"...
Re:Technical debt as a lack of understanding by trhway on Friday November 06, 2020 @05:58PM (#25011937)
that is pointless. It isn't about message, it is all about messenger. If they don't want to listen to you, they wouldn't. My friend who has made his way pretty high here in the SV told me recently how the same CXX/"boardroom" people who wouldn't listen even to his 1 sentence, now have all the time and attention in the world to listen to him all day long.
Re:Technical debt as a lack of understanding by croh on Saturday November 07, 2020 @01:08AM (#25013461)
This is true. You can always try to convince people but if you're not string puller, you're in mercy of listeners. If they fix on something (e.g.profit, own promotion), your story should be aligned to that(their KPI). Then only you can have hope.

When shit breaks, no one wants to take blame and people start to forget 'selectively' your earlier warnings of shit.

Re:Technical debt as a lack of understanding by tehjoker on Friday November 06, 2020 @05:34PM (#25011792)
It could be an additional service to something else, like a café. I think the metaphor is reasonable.