Live data from Hacker News

Software is narrative

infiniteundo.com

11–20 of 43 posts

Re: Software is narrative

#11
post #6
post #4

Sorry I just don't understand the article. Can anyone rephrase?

The main point of the article appears to be: > You always have to design both “the product” your customers want and “the environment” in which your product will run in production. Thus any software product begins with two obvious categories of “work to be done.” People ignore this because it seems [counterintuitive.][going_there]

Hey you saved everyone a click!

I am the author of the post and I approve this summary :)

Re: Software is narrative

#12
post #7

Okay, I'll take it at face value. Can you name a few competent programmers who are also competent book / story writers ?

The Martian was fantastic and the author is a programmer. I recently got hooked on the Bobiverse books and their author is a programmer too. In fact, I wholly recommend anyone reading this to check both of those out :) Super fun books

Re: Software is narrative

#13
post #7

Okay, I'll take it at face value. Can you name a few competent programmers who are also competent book / story writers ?

I believe Ken MacLeod was a programmer and he is an great writer (along with Stross and Vinge mentioned in a sibling comment)

https://en.wikipedia.org/wiki/Ken_MacLeod

Re: Software is narrative

#14
post #6

Earlier quoted context omitted.

The main point of the article appears to be: > You always have to design both “the product” your customers want and “the environment” in which your product will run in production. Thus any software product begins with two obvious categories of “work to be done.” People ignore this because it seems [counterintuitive.][going_there]

Hey you saved everyone a click! I am the author of the post and I approve this summary :)

Your blog archive (where the title links to) seems to be broken.

Re: Software is narrative

#16

Earlier quoted context omitted.

Hey you saved everyone a click! I am the author of the post and I approve this summary :)

Your blog archive (where the title links to) seems to be broken.

Weird it just worked fine for me. http://infiniteundo.com/archive/filter-by/text

Re: Software is narrative

#18
post #17

Just wondering if I'm the only one, but I like my logs to be the narrative of what's happening in the system.

That's where I was going when I wrote this post. Logging and log analysis is a large part of the continuous delivery tooling that I've been working on for the past 7 years.

Re: Software is narrative

#19
post #7

Okay, I'll take it at face value. Can you name a few competent programmers who are also competent book / story writers ?

I create video training courses on tech topics and one of the metrics I use to determine "is this performing well?" is the completion rate of the courses and individual videos.

I started taking communication and story telling pretty seriously about 9 months ago and the data on my 2 latest courses (where I tried to create a cohesive narrative of the content) shows the completion rate being quite a bit higher than my older courses.

Are there other things at play? Maybe, but I'm 100% convinced it takes more than "raw programming talent" to be a good programmer in general.

When it comes to designing library code or public APIs, I would rather use code written by someone with 5 years of writing / story telling experience and 2 years of coding experience vs someone with 10 years of coding experience but can't communicate well at all.

Chances are the 2nd person wouldn't be able to see the "big picture" stuff when it comes to designing APIs, and when it comes to API design, the big picture is the most important thing. The implementation details of each function is the easy stuff (since you're a Google search away from solving most technical problems).

There's also many other factors that matter besides your code. For instance, if I can't even find your project, or your documentation is lack luster then it doesn't matter if you wrote the most elegant code in the universe, I'm not going to use it.

Post reply on HN