News for hackers. Stuff that matters.
Re:Things I’ve learned in my 20 years as a software engineer by boffinAudio on Friday October 08, 2021 @06:32AM (#28797671)
40+ years of experience here, and I'll tell you the #1 thing I've learned:

    * Software is a social service.  Its for other humans.
Incredibly, it doesn't matter how educated the developer, they still seem to have to learn this lesson themselves, over and over, until it sinks in...
Re:Things I’ve learned in my 20 years as a software engineer by chaps on Friday October 08, 2021 @09:49AM (#28799270)
I do a lot of dev work with non-profits and such. About a year ago I was working on an extremely difficult project as a volunteer where I was insistent that a specific part was vitally important to getting the project to move forward (generalizing tables extraction from scanned OCR docs) and I was spending a lot of time on it. One of the devs I worked with, with 40+ years of experience, basically told me this exact thing. He argued that what I as working on was a waste of time and that I shouldn't work on "code golf" problems, because of the likelihood of failure and that ultimately I should consider the human side of the problem. He said it was best to work on other things instead.

Fast forward a month later, I managed to actually do it, and it worked almost flawlessly, across about 100k scanned PDFs. Multiple long-term projects spawned off from the extracted information, including some projects from the dev who told me to stop.

My point being -- sometimes it seems like that line is used as an excuse to not tackle hard problems if they seem likely to fail. I agree with the line, and it's the exact reason I worked on it as hard as I did, but the dev failed to consider that I understood the social part of the problem, on experienced principle.

Re:Things I’ve learned in my 20 years as a software engineer by bobthepanda on Friday October 08, 2021 @11:22AM (#28800274)
> generalizing tables extraction from scanned OCR docs

I would actually categorize this as a human problem. As a society, we scan documents all the time. Data entry is a massive time sink usually involving lots of corrections.

True code golf would be like switching languages/frameworks for no discernable reason or trying to hit an arbitrary code coverage metric because you're unsatisfied with the current one.

Re:Things I’ve learned in my 20 years as a software engineer by xwolfi on Friday October 08, 2021 @01:30PM (#28801748)
It's a permanent balance. I have to "manage" (but I still am a main contributor) a small team in a big investment bank with angry busy trader-users, irrational "global" management in other continent thinking we're all dumbasses in Asia, and people on loaned rotation.

So, like your colleague, I try to strategize delivery. I would never tell a guy not to work on a genius idea that could change the entire paradigm, in fact I let 3 of my guys do just that for the last 3 months, together, sometimes alone. But they either not deliver, or very slowly, or sketchily (not working as well as thought).

So what I do a lot is a compromise. I force them, despite their complaint I don't care enough about the big picture of their non-delivering work, to take smaller issues every week. 1 or 2, give a candy to the user, and do your stuff then.

It worked incredibly well: while they've delivered absolutely nothing of value in their own initiatives yet (but I still think they can, it's just very long term), the users are delighted by a constant stream of little innovations and we've been recently identified as one of the most productive team.

Meanwhile, the team next to us, algo programmers in C++, can take 2 months to enhance an error message. Because they're all revolutionizing the system and have no time for basic human needs. They don't know yet, but they're gone soon. The budget people found there's a new model of delivery that could work, I wonder which one ;)

Re:Things I’ve learned in my 20 years as a software engineer by bGl2YW5j on Friday October 08, 2021 @08:58PM (#28806026)
Good on you for trusting your team and allowing for such experimentation! We need more people in management with this attitude.
Re:Things I’ve learned in my 20 years as a software engineer by cbsmith on Friday October 08, 2021 @10:51AM (#28799968)
As per the blog's opening statement: context is key.

The industry (and really, it's not specific to the industry) is rife with people who take pearls of wisdom out of their context and apply them without the context to serve their own ends.

Re:Things I’ve learned in my 20 years as a software engineer by agumonkey on Friday October 08, 2021 @06:47PM (#28805001)
minuscule anecdote: my most cherished lines of code were an 8 lines vba excel macro to count duplicates for a non tech colleague.

Turned her day from hell to cool (she had to filter duplicates by hand and quadratic formulas over 2000+ lines spreadsheet.

That's what computers are for.

Re:Things I’ve learned in my 20 years as a software engineer by suzzer99 on Saturday October 09, 2021 @12:13AM (#28806997)
I once spent two hours thinking about how to recursively assemble a tree structure from the database in a way that the JS presentation library wanted the data, then finally I wrote 2 lines of code.

Definitely my most cherished code.

Re:Things I’ve learned in my 20 years as a software engineer by chaps on Saturday October 09, 2021 @04:40PM (#28813100)
Hah, this is something I've done when trying getting data from a government agency that can't run or write code themselves. It's usually in some awkward meta-adversarial context and they tend to be fearful of macros and such, but it's possible to get around that fear by writing everything in excel functions.

Sometimes those damn excel sheets take hours and hours to make even though it would otherwise take me less than a minute to write in SQL or unix. But it pays off every time and pushes a clear message that they can do better.

Re:Things I’ve learned in my 20 years as a software engineer by WalterBright on Friday October 08, 2021 @01:57PM (#28802111)
> sometimes

Any rule of wisdom, followed blindly, leads to disaster.

Don't substitute rules for good judgement.

Re:Things I’ve learned in my 20 years as a software engineer by vvanders on Friday October 08, 2021 @09:36PM (#28806227)
Or sometimes you have an approach that is high risk/reward. That's totally fine to take as long as your aware of the risk and have mitigations or offramps at the right points if you find the path isn't viable.
Re:Things I’ve learned in my 20 years as a software engineer by Y_Y on Friday October 08, 2021 @06:22PM (#28804814)
If we take your first statement to be a "rule of wisdom" then it is either false, or all roads lead to disaster anyway.
Re:Things I’ve learned in my 20 years as a software engineer by WalterBright on Friday October 08, 2021 @06:57PM (#28805067)
If you leave off the rest of my post, you're likely to misunderstand it :-)
Re:Things I’ve learned in my 20 years as a software engineer by darthvoldemort on Friday October 08, 2021 @10:16AM (#28799523)
If you're volunteering, why shouldn't you work on projects that you find interesting? I don't understand the point of view of the older dev.
Re:Things I’ve learned in my 20 years as a software engineer by inglor on Friday October 08, 2021 @10:32AM (#28799733)
I've found that volunteer work is _harder_ in terms of getting the human aspect right.

New volunteers sometimes expect the red-carpet treatment as someone volunteering their (pretty expensive presumably!) time and as someone accomplished in their field. Volunteers usually get the opposite treatment since it turns out the other volunteers tend to come from a similar perspective and someone doing the hard human work is often contributing a lot more to the project than an otherwise excellent engineer.

You can of course choose your volunteer activities to be interesting to you. Open source is one such very fun activity but lo-and-behold in projects I've been involved with the human aspect is often very important and requires a similar amount of hard work. This is often truer for bigger projects/organizations than small ones.

Re:Things I’ve learned in my 20 years as a software engineer by schraeds on Friday October 08, 2021 @10:22AM (#28799596)
Even if you're volunteering you still have to work towards agreed upon objectives. You wouldn't show up on a Habitat for Humanity build site an start modifying the blueprints and working on whatever you found interesting because you are volunteering and are entitled to only work on interesting projects.
Re:Things I’ve learned in my 20 years as a software engineer by minitoar on Friday October 08, 2021 @10:20AM (#28799583)
Presumably you want to maximize the positive impact your volunteering has on others.
Re:Things I’ve learned in my 20 years as a software engineer by darthvoldemort on Friday October 08, 2021 @10:23AM (#28799612)
But having people working on potentially extremely useful moonshots that they are interested in for free is a huge win. I think it's really just a case of bad advice, and not all developers with 40+ years of experience are correct. In my opinion, it's better to have a motivated volunteer engaged and working on something with unknown impact that she is interested in, rather than get her to work on boring things with less impact.
Re:Things I’ve learned in my 20 years as a software engineer by throwaway14356 on Friday October 08, 2021 @11:01AM (#28800090)
of course not, humans are most often wrong about everything. Someone with experience is just that. Our perspective changes.

I started coding at 12 because everyone said it was much to hard for me. Now im old and motivate people by doing the same. At the same time its good to be reminded by others what happens if you drop one thing in favor of the other.

Re:Things I’ve learned in my 20 years as a software engineer by quickthrower2 on Friday October 08, 2021 @08:12PM (#28805703)
Predicting the future is hard. You were both right. You only have the outcome to judge the decision, not the full probability distribution.
Re:Things I’ve learned in my 20 years as a software engineer by superpope99 on Saturday October 09, 2021 @10:43AM (#28810299)
This is so important - it's so hard to gauge what another person's mental model of a scenario is compared to yours.

As in - perhaps OP and 40+ year person had the same, accurate mental model of the probability distribution of success, but OP and 40+ had different attitudes towards risk/reward.

Or perhaps the OP happened to have a much more realistic picture of the probability of success, and 40+ was unnecessarily pessimistic.

So hard to evaluate these things, and to internalise the fact that other people don't have the information you have all the time.

Re:Things I’ve learned in my 20 years as a software engineer by chaps on Saturday October 09, 2021 @05:01PM (#28813271)
Yep! If I wasn't successful, he would have been right and I can't really blame him too much for thinking it his way. The problem was particularly tricky because it combined bunches of distinctly esoteric domains (OCR, text/vector maps, image processing, fuzzy string matching).. recursively. There were no boundary lines and inconsistently sized black redaction boxes. If I hadn't worked on problems in each domain in separate projects, I doubt I would've been able to do it and he had no way of knowing my experience.
Re:Things I’ve learned in my 20 years as a software engineer by dempseye on Friday October 08, 2021 @11:01AM (#28800089)
Make an API out of that. There is huge demand for it.
Re:Things I’ve learned in my 20 years as a software engineer by agustif on Friday October 08, 2021 @01:32PM (#28801771)
I needed to do this, so happy someone else made it!

A nice FOSS library for it was on HN recently, sharing is caring I guess

https://news.ycombinator.com/item?id=28680136

https://extract-table.com/

https://github.com/vegarsti/extract-table

Re:Things I’ve learned in my 20 years as a software engineer by mediascreen on Friday October 08, 2021 @12:54PM (#28801334)
I'm pretty sure AWS Textract does that already.

https://aws.amazon.com/textract/

Re:Things I’ve learned in my 20 years as a software engineer by mvcatsifma on Friday October 08, 2021 @11:15AM (#28800221)
I believe such an API already exists: https://pdftables.com/ (no affiliation).

Went to a presentation at a Golang meetup in Amsterdam by the guys behind this company. Seemed to know their stuff. But I have no real world experience using it.

Re:Things I’ve learned in my 20 years as a software engineer by vic-traill on Friday October 08, 2021 @11:30AM (#28800360)
I had a look - from their FAQ [0]:

However, some PDFs are scanned documents, or only contain images. PDFTables doesn't perform Optical Character Recognition (OCR) to turn these images into text.

To process these kinds of documents, you will need to either enable OCR in your scanning software, or run the PDF through specialist OCR software before using PDFTables.

[0] https://pdftables.com/faq

Re:Things I’ve learned in my 20 years as a software engineer by leesalminen on Friday October 08, 2021 @11:13AM (#28800206)
I’m in need of that right now! Would pay for it, especially if the proceeds benefitted that non-profit!
Re:Things I’ve learned in my 20 years as a software engineer by mlboss on Friday October 08, 2021 @11:46AM (#28800536)
Re:Things I’ve learned in my 20 years as a software engineer by SavantIdiot on Friday October 08, 2021 @02:13PM (#28802291)
30+ years here, so I'm just a youngster compared to you, but yes, that seems to get lost.

My first mentor in the 80's was a jolly drunken programmer genius who enjoyed getting me to laugh at how bad my code was.

His biggest lesson was that other people need to read and use my code, not just me. It isn't enough to just hack a solution -- "Anyone CAN write code, but not everyone SHOULD write code" was his favorite quote -- but code needs "style" and "heart".

He even had a t-shirt made for me after my internship ended that had those two words and a bunch of my worst code examples printed on it. I still have it: just a bunch of MASM code. I'll Never forgot that guy.

Re:Things I’ve learned in my 20 years as a software engineer by euske on Friday October 08, 2021 @08:30AM (#28798445)
I think this applies to not just software, but engineering in general. See, science is mostly about observing the natural phenomena. On the other hand, there are jobs that are mostly about taking care of people's needs. Engineering sits in the middle. It's a mediator. We have to understand the circumstance of both sides - nature (this could be something like hardware capacity in our case) AND people. Just taking care of one side makes you a bad engineer. You need to be technical and sympathetic at the same time.
Re:Things I’ve learned in my 20 years as a software engineer by pydry on Friday October 08, 2021 @09:12AM (#28798852)
It applies to every job not just engineering. I thought this was considered obvious.
Re:Things I’ve learned in my 20 years as a software engineer by BoiledCabbage on Friday October 08, 2021 @09:45AM (#28799218)
To clarify, you're saying that you vire that that being technical and observing natural/physical phenomena are important parts of selling clothing at retail, being a novelist and working as a receptionist?

I think those are important jobs, and completely disagree with you. I'm trying to understand if those are jobs you weren't considering, or if we view each the responsibilities of those jobs very differently.

Re:Things I’ve learned in my 20 years as a software engineer by pydry on Friday October 08, 2021 @09:59AM (#28799367)
No. I'm saying that retail, much like being a novelist or a receptionist or a software programmer or indeed any job is, as the OP puts it, a "social service".

That being one of the defining charactetistics of a job.

Re:Things I’ve learned in my 20 years as a software engineer by BoiledCabbage on Saturday October 09, 2021 @02:58PM (#28812292)
You're saying you're agreeing with OP, but your statements contradict.

OP calls out 3 categories of jobs. Mainly natural/technical, mainly social, and those which sit in the middle and require both. Finally OP says engineering sits in the middle and requires both.

You said it's not just engineering (that requires both), but all jobs.

Both I and OP disagree with that statement.

Re:Things I’ve learned in my 20 years as a software engineer by pydry on Monday October 11, 2021 @06:31AM (#28826760)
So, which jobs are not providing a "social service"?
Re:Things I’ve learned in my 20 years as a software engineer by CRConrad on Monday October 11, 2021 @09:45AM (#28828226)
Car mechanics? Sure, in the end it's "social" in that another human being benefits from it, but the actual "social" aspects of the actual work are handled by someone other than the mechanic.
Re:Things I’ve learned in my 20 years as a software engineer by lazide on Friday October 08, 2021 @09:44AM (#28799211)
For many people it definitely is not - some folks get into software engineering because they have the mistaken (albeit not as mistaken as if they were going into another career like medicine!) belief they can avoid people and just deal with machines.
Re:Things I’ve learned in my 20 years as a software engineer by pjmlp on Friday October 08, 2021 @07:28AM (#28798005)
Approching the same experience level and fully agree.

A piece of coding art that doesn't fulfill customer needs, or requires understading of language standard minutia for fellow devs to do maintainance updates is worthless.

Re:Things I’ve learned in my 20 years as a software engineer by lazide on Friday October 08, 2021 @09:45AM (#28799226)
Yes, or in some cases even worse than useless - an active problem that requires expensive specialization to not make things an even bigger mess
Re:Things I’ve learned in my 20 years as a software engineer by CRConrad on Monday October 11, 2021 @09:46AM (#28828234)
Re:Things I’ve learned in my 20 years as a software engineer by bbarn on Friday October 08, 2021 @03:47PM (#28803367)
The biggest mistake people in our industry make is thinking they are somehow exempt from the rules of society and business just because they can use a computer better than most people.

Heads down genius coder everyone steps around ends up fired or stuck in mid level forever, in reality. Guy who makes friends with the Customer Service department and Sales team with mediocre fixes get promoted, and in reality achieves more with his career.

Software is useless without users.

Re:Things I’ve learned in my 20 years as a software engineer by 535188B17C93743 on Friday October 08, 2021 @10:01AM (#28799396)
What's the quote? Knowledge can be taught. Wisdom can't be taught or told... it can only be learned through experience?

Edit: Ah, found it.

"Wisdom cannot be imparted. Wisdom that a wise man attempts to impart always sounds like foolishness to someone else ... Knowledge can be communicated, but not wisdom. One can find it, live it, do wonders through it, but one cannot communicate and teach it." - Siddhartha

Re:Things I’ve learned in my 20 years as a software engineer by hutzlibu on Friday October 08, 2021 @10:06AM (#28799432)
"Wisdom can't be taught or told... it can only be learned through experience"

I recently had the thought, that good education guides you to certain experiences to really learn the subject and not memorize some definitions.

Re:Things I’ve learned in my 20 years as a software engineer by Jensson on Friday October 08, 2021 @10:46AM (#28799905)
Problem is that people learn the wrong things from their experiences, not that they lack the experiences.
Re:Things I’ve learned in my 20 years as a software engineer by ArteEtMarte on Friday October 08, 2021 @11:49AM (#28800579)
The way I was told it: "Knowledge is knowing it's a one-way street. Wisdom is learning to look both ways anyway."
Re:Things I’ve learned in my 20 years as a software engineer by nonima on Friday October 08, 2021 @06:44AM (#28797738)
Software is whatever you want it to be. I can write software that is not for other humans. That's the most fun part of software engineering to me, when you don't care about the users and just do it just for the fun of doing it.
Re:Things I’ve learned in my 20 years as a software engineer by goto11 on Friday October 08, 2021 @09:06AM (#28798794)
Almost any advice is useless if you write code purely for your own enjoyment. This is why the context is so important. If you enjoy writing convoluted unmaintainable useless code then who is to stop you? Just understand most advice does not apply to your context.

Most software development advice tacitly assume you want to write code which works and is long-term maintainable (potentially by someone other than yourself) and which fulfills some purpose beyond just the fun of writing the code.

Re:Things I’ve learned in my 20 years as a software engineer by matheusmoreira on Friday October 08, 2021 @02:58PM (#28802790)
> If you enjoy writing convoluted unmaintainable useless code then who is to stop you?

Does anyone actually do this? I think it's the opposite.

I've spent truly absurd amounts of time thinking about how to do things properly. I read books, read other people's code, read programming language implementations, I just read and learn as much as I possibly can before I even start doing anything. I want my code to be right. I want it to represent the truth of how the world works.

In a professional context where people actually have deadlines, working code is usually enough to satisfy them. How complex and maintainable it is tends to be a lesser concern, to be addressed at a later time or never.

Re:Things I’ve learned in my 20 years as a software engineer by warkdarrior on Friday October 08, 2021 @04:18PM (#28803714)
> > If you enjoy writing convoluted unmaintainable useless code then who is to stop you?

> Does anyone actually do this? I think it's the opposite.

Code style, structure, and design are more of an art than a science, so different people will have wildly different opinions (extreme examples notwithstanding).

Re:Things I’ve learned in my 20 years as a software engineer by goto11 on Saturday October 09, 2021 @06:47AM (#28808682)
I don't think anyone deliberate writes unmaintainable code except as a joke. Hard to maintain code happen when some other objective takes priority - performance, abstractions, architectural purity, DRY or whatever else a developer might enjoy focusing on.

The most maintainable code tend to be the least clever. But developers enjoy being clever, so without any outside pressure to deliver maintainable code, developers will tend towards less maintainable code.

Re:Things I’ve learned in my 20 years as a software engineer by mattcwilson on Friday October 08, 2021 @06:55AM (#28797796)
And, as the article says, your advice and the GP’s are contextual.

If you’re interested in creating software that makes people happy, solves their problems, gets cherished and recommended - then work hard to not lose sight of that goal in the thick of crafting a massive code edifice.

If you’re interested in pushing the limits of your own creativity, and building a technical structure capable of handling domain complexity with ruthless efficiency - then sure, don’t worry too much about how it looks, how it reads, or how others respond to it.

If you’re lucky, you might get to do both in the same body of code. But not likely.

Re:Things I’ve learned in my 20 years as a software engineer by boffinAudio on Friday October 08, 2021 @07:01AM (#28797833)
Even if YOU are the only user, you're still writing software for a human.

Hopefully.

Re:Things I’ve learned in my 20 years as a software engineer by Jensson on Friday October 08, 2021 @07:28AM (#28798012)
With that argument you could say that everything humans ever did was for humans. So either it is a platitude or it is wrong.
Re:Things I’ve learned in my 20 years as a software engineer by boffinAudio on Friday October 08, 2021 @07:35AM (#28798071)
You could say that, but my cat thinks you'd be wrong.

However, I'm yet to see my cat boot up the computer.

Re:Things I’ve learned in my 20 years as a software engineer by Jensson on Friday October 08, 2021 @07:51AM (#28798172)
Ultimately pets are for humans, whatever you do for your cat you do for humans. The same logic works there.
Re:Things I’ve learned in my 20 years as a software engineer by bloak on Friday October 08, 2021 @08:17AM (#28798361)
With cats it's the other way round: the humans for cats.
Re:Things I’ve learned in my 20 years as a software engineer by Jensson on Friday October 08, 2021 @08:20AM (#28798382)
And from a computers perspective all human work is ultimately for computers. Either making them or feeding them data. The purpose of the cat is to generate cat pictures for the computer etc.
Re:Things I’ve learned in my 20 years as a software engineer by ta988 on Friday October 08, 2021 @09:48AM (#28799257)
My cat would often turn the computer on or the tv off, and I swear he did it on purpose because that's when he was complaining he didn't got enough attention.
Re:Things I’ve learned in my 20 years as a software engineer by SketchySeaBeast on Friday October 08, 2021 @09:44AM (#28799203)
My cat has turned off my computer on me - does that count?
Re:Things I’ve learned in my 20 years as a software engineer by ninkendo on Friday October 08, 2021 @08:39AM (#28798514)
You’re writing software for all of your future selves.

http://www.catb.org/~esr/writings/unix-koans/prodigy.html

Re:Things I’ve learned in my 20 years as a software engineer by pksebben on Saturday October 09, 2021 @12:47AM (#28807137)
Thank you for posting this. I feel understood.
Re:Things I’ve learned in my 20 years as a software engineer by dynamite-ready on Friday October 08, 2021 @08:28AM (#28798432)
But then we can also go the other way, and forget how crazy and diverse humans are. So you will still, eventually, end up facing the same challenge, framed differently.
Re:Things I’ve learned in my 20 years as a software engineer by lucumo on Friday October 08, 2021 @07:06AM (#28797866)
Well, you could create software as art. Basically to create it for the fun of creating it, not to use it.

But yeah, the end result is useless then, and can be thrown out.

Re:Things I’ve learned in my 20 years as a software engineer by lazide on Friday October 08, 2021 @09:48AM (#28799264)
Or, like some art, of variable degrees of folks caring about it based on other interesting properties - and made for some purpose other than maintainability.

Demoscene, obfuscated coding contests, etc. seem to fall under that category.

Uselessness in the eye of the beholder or something like that.

Re:Things I’ve learned in my 20 years as a software engineer by lucumo on Friday October 08, 2021 @12:04PM (#28800795)
But in those cases you are creating for other people. The point was made about software that didn't have any use for any people.

In those cases, only the creation itself has a use, not the end result. By definition.

Re:Things I’ve learned in my 20 years as a software engineer by nkssy on Friday October 08, 2021 @09:47AM (#28799248)
Don't forget to write for future you. They'd appreciate some consideration as well. Mostly along the lines of "wtf does this module do?"
Re:Things I’ve learned in my 20 years as a software engineer by throwaway14356 on Friday October 08, 2021 @11:11AM (#28800185)
The best one for me was documentation to complicated for me - by me.
Re:Things I’ve learned in my 20 years as a software engineer by nkssy on Friday October 08, 2021 @11:56AM (#28800660)
You seem to have a complicated relationship with your past self. I foresee further trouble in your future. Its best if you take a torch or you'll be eaten by a grue.
Re:Things I’ve learned in my 20 years as a software engineer by matheusmoreira on Friday October 08, 2021 @02:54PM (#28802745)
> when you don't care about the users and just do it just for the fun of doing it

Yes!! That makes me so happy.

Re:Things I’ve learned in my 20 years as a software engineer by koonsolo on Friday October 08, 2021 @07:04AM (#28797853)
So you write code in machine language? Or are you writing in a language that tries to be readable by English speaking humans?
Re:Things I’ve learned in my 20 years as a software engineer by schwartzworld on Friday October 08, 2021 @07:07AM (#28797874)
Or they write it for themself and not _other_ humans.
Re:Things I’ve learned in my 20 years as a software engineer by j7ake on Friday October 08, 2021 @07:28AM (#28798010)
Your future self can be seen as “other” humans given a long enough time frame.

Anybody who has looked at their own code done more than 5 years ago can surely attest.

Re:Things I’ve learned in my 20 years as a software engineer by SketchySeaBeast on Friday October 08, 2021 @09:44AM (#28799216)
5 years is optimistic. A lunch break can be enough.
Re:Things I’ve learned in my 20 years as a software engineer by mooreds on Friday October 08, 2021 @07:34AM (#28798056)
Can't agree with this enough. Sometimes it is directly for other humans (a GUI), other times it is indirectly related (an ETL job that converts data into a form that can be easily used to drive a recommendation engine which provides recommendations ... to people).

This is tied into asking "why", another one of the author's points. At the end of the day, if you dig deep enough, the why will be related to human happiness.

Bonus! If you keep this in mind, you'll also gain perspective. While you don't want to live at 30k feet all the time, periodically gaining high level perspective of the problem you are solving has been, for me, one of the joys of software development. (Not the only one, but definitely a significant one.) Hopefully it is that way for you too.

Re:Things I’ve learned in my 20 years as a software engineer by kiklion on Friday October 08, 2021 @08:30AM (#28798443)
> At the end of the day, if you dig deep enough, the why will be related to human happiness.

At one of my jobs, one of my tasks was to take client HR feeds and load them into downstream systems for travel management. On your second day of employment at your company, you should have a profile in our system which was a portal that displayed all travel policies and a profile in whatever booking tool your company used.

We knew who your manager was so approval emails went out automatically. We knew what corporate card was assigned to you, so you never had to deal with that. We knew what preferred vendors your company had agreements with etc

All I was doing was data manipulation and loading on a scheduled or triggered basis. But ultimately it allowed new hires in a new environment to have an easy time booking their trip for mandatory training.

Any time our process failed, you had a traveler stressed out that they wouldn’t be able to book the trip in time or have to outlay money and reimburse later or get stuck at a distant airport.

Re:Things I’ve learned in my 20 years as a software engineer by dxbydt on Friday October 08, 2021 @12:36PM (#28801217)
> Software is a social service. Its for other humans.

I deeply disagree with this Calvinist utilitarian sentiment. Its akin to saying sex is for making babies. Maybe its an academic thing - When I went to grad school for CS, on Day 1 my Algorithms Professor paraphrased Perlis's famous quote on the blackboard - "Shaft the paying customer!"

You can find the whole quote on the first page of SICP[1], or elsewhere[2]. imho its a highly toxic sentiment to think that whatever a programmer does is for other humans. Software as a Social Service...SAAS :)

imho the best software is written to scratch a personal itch. Not to appease this customer. Not for other humans. Not as a social service. In fact all the people I deeply admire in the software world - Arthur Whitney, Kenneth Iverson, Mattis & Kimball, Perlis, Dijkstra, hell even Linus, are generally characterized as egotistical assholes in the public space who really don't give a flying fuck about social service & humans but care deeply about the software they created for their own selfish reasons.

Mattis is quite explicit about this - "You should understand that the GIMP and GTK weren't written to fill holes in the software available under the GPL...GIMP was started because I wanted to make a Web page. GTK was started because I was dissatisfied with Motif...These are purely selfish reasons. That is probably why the projects...eventually succeeded. I find it much more difficult to work on something for selfless reasons."

Perlis - "I hope we don’t become missionaries. Don’t feel as if you’re Bible salesmen. The world has too many of those already. What you know about computing other people will learn."

otoh the people I deeply detest in software (too numerous to name) are generally these do-gooder types who write software to save the world & provide social service, employment to the masses, add "value" insert-marketing-speak-here etc...

I'm ok with the hypocrisy in pretending to care about software as a social service because I need to put food on the table like any other programmer on the market, but deep inside, I write code only for myself. I think a big fraction of developers are like that. There's no harm in saying it out loud.

[1]https://cloudflare-ipfs.com/ipfs/QmQ3C4ooSCmBMuK7mKq4sqVAfGq...

[2]https://www.goodreads.com/quotes/405620-i-think-that-it-s-ex...

Re:Things I’ve learned in my 20 years as a software engineer by BoiledCabbage on Saturday October 09, 2021 @03:58PM (#28812717)
> imho the best software is written to scratch a personal itch. Not to appease this customer. Not for other humans.

This statement shows you partially understand, but don't understand the why. You recognize that people working on software for things they truly care about can write better more successful software, but you miss the final step of why that software is more successful.

The reason why Linus can write such great software for software engineers is because he is a software engineer. Fundamentally the software you love is successful for other people, it is for other people and because your idols are one of those people part of that group, they understand it as well as anyone.

Linux was made for passionate hobbyist programmers by a passionate hobbyist programmer. And because it is made for those people, and met their needs perfectly is why it caught on. The reason it met their needs is because Linus understood their needs, because he shared them.

That's the key piece - that great software is written by completely meeting users needs. The easiest way to understand and meet other people's needs is by sharing them. That's the final step of it.

Fundamentally software becomes successful by meeting other people's needs. Anything else that doesn't, you've never heard of.

Re:Things I’ve learned in my 20 years as a software engineer by hnfong on Saturday October 09, 2021 @03:55AM (#28807893)
> imho the best software is written to [...]

What do you mean by "best"? If it is supposed to be judged by the original author of the software alone, your opinion does not matter. If you think your opinion of software written by others matters, then BAM, you've acknowledged what you set out to refute, i.e. Software is written for (or at least its quality can be judged by) other humans. (Unless you're actually a GPT-3 bot in disguise, in which case you win :D)

What you might have shown is that software not written for others can still be great in the eyes of other people, but even that is somewhat nuanced. IIRC one of Linus' egotistical outbursts was triggered by a kernel dev intentionally breaking user-space compatibility. At least in this case Linus' example doesn't support your claims.

I also don't see why "software is written for other humans" necessarily snuffs the fun or interesting aspects out of it. There certainly are large number of un-fun software that serves a commercial purpose, but it doesn't mean that fun software has to be anti-social. Even entries submitted to IOCCC (purposely obfuscated C code written purely for fun) sometimes lead to useful stuff (Fabrice Bellard's work).

Re:Things I’ve learned in my 20 years as a software engineer by wizzwizz4 on Friday October 08, 2021 @01:02PM (#28801443)
> provide social service, employment to the masses,

If I want the computer to do XYZ, and I can provide an XYZ service to other people? They're paying me to do my bug testing, and I get to feel good about it.

If you're providing something that you think is a really good service, but not for people like you, and not for somebody specific you know either, it's probably going to be rubbish.

Re:Things I’ve learned in my 20 years as a software engineer by spion on Friday October 08, 2021 @02:16PM (#28802331)
So if Linus works on Linux for his own selfish reasons, howcome Linux isn't a one-person effort that nobody else is using? And why did they pick the GPL?

It sounds to me like you're describing bad social behavior but generally altruistic motivations with good social behavior but non-altruistic motivations, and you prefer the former over the latter. Sure, thats fine.

Re:Things I’ve learned in my 20 years as a software engineer by vnorilo on Friday October 08, 2021 @10:12AM (#28799493)
I think software is human expression. It can be a social good or a business driver. But it does not have to be. It can have no users, no IO or never run on a computer and still encode deep meaning.

Does it need to be social to be useful? That is a value system.

Many here communicate (beautiful) value systems, and that's great! But ideas and software can transcend those.

Re:Things I’ve learned in my 20 years as a software engineer by svilen_dobrev on Friday October 08, 2021 @10:04AM (#28799412)
35y+ here, i just sent him something along:

"software is communication, made by people, for people"

(which is more or less what you say :)

With all the consequences. Most people, on either side, don't get it. Ever.

Re:Things I’ve learned in my 20 years as a software engineer by chii on Friday October 08, 2021 @06:37AM (#28797706)
you can replace the word "software" with basically any other professional work and that is still the same. I don't know what you can learn from the fact that it's a social service.
Re:Things I’ve learned in my 20 years as a software engineer by wccrawford on Friday October 08, 2021 @07:33AM (#28798051)
I've met a lot of people who are writing code to satisfy requirements and collect a paycheck. They're good people, but just don't automatically think about the end user. They stop when the requirements are met, instead of when the user will be happy.

That's what they're supposed to learn from that, IMO.

Re:Things I’ve learned in my 20 years as a software engineer by chii on Friday October 08, 2021 @08:57AM (#28798706)
> They stop when the requirements are met, instead of when the user will be happy.

that's because they are doing software "for other humans" - aka, their manager and PM, who gave them the requirements.

So the problem is not the software engineer, but the person who creates those requirements to be fulfilled.

Re:Things I’ve learned in my 20 years as a software engineer by lazide on Friday October 08, 2021 @09:52AM (#28799305)
I think what the parent may have been complaining about is essentially myopia in interpreting things - ‘well, this technically checks the box of what they ask for’ while willingly avoiding thinking about the larger context of what is being attempted or trying to understand requirements that don’t make much sense.

Don’t get me wrong - it has it’s place, and if everyone always tried to understand everything, there are a lot of organizations and situations it would be crushing - but it’s also very frustrating in many situations for those who want high quality products.

It’s the ‘not my job’ syndrome, essentially.

Re:Things I’ve learned in my 20 years as a software engineer by dragonwriter on Friday October 08, 2021 @11:33AM (#28800392)
> I think what the parent may have been complaining about is essentially myopia in interpreting things - ‘well, this technically checks the box of what they ask for’ while willingly avoiding thinking about the larger context of what is being attempted or trying to understand requirements that don’t make much sense.

I think what your post’s parent was pointing out is that in lots of environments, such myopia is just an engineers job definition, for which they will be punished if they stray. Interpreting end-user needs is someone else's job.

Re:Things I’ve learned in my 20 years as a software engineer by lazide on Friday October 08, 2021 @01:57PM (#28802116)
I think we just violently agreed, and even repeated the same last line?
Re:Things I’ve learned in my 20 years as a software engineer by wccrawford on Friday October 08, 2021 @02:27PM (#28802453)
I'm not asking that develop to go against the requirements. But it's often possible to satisfy requirements without satisfying the user, even though it's actually possible to do both.
Re:Things I’ve learned in my 20 years as a software engineer by jimbokun on Friday October 08, 2021 @11:28AM (#28800343)
Some organizations are structured such that it is difficult for an engineer to do anything else. An engineer doesn't always have access to the end user, unfortunately.
Re:Things I’ve learned in my 20 years as a software engineer by boffinAudio on Friday October 08, 2021 @06:39AM (#28797720)
Well, all economy is human economy, so yeah .. okay.

You can learn from the fact that its a social service by actively NOT resisting the truth of this fact.

Incorporate it into your thinking with every commit you make and you will become a better programmer over time.

(Corollary: those developers who forget this fact, make shitty software...)

Re:Things I’ve learned in my 20 years as a software engineer by Jensson on Friday October 08, 2021 @07:32AM (#28798040)
Everyone agrees that software is to serve humans. What they disagree about is how to best make software that serves humans.

For example, lets say you write an API that translates text. Should you assume the text the human sent in is correct and return an error? That way you can make better translations when they send the right data. Or should you try to be helpful and automatically fix spelling errors you think you've found in order to make the API more human friendly? Would make it easier but reduce accuracy.

You seem to be in the second camp, reduce power of API and make them easier to use. But lots of people think that the best way to serve humans is to make more powerful and strict API's.

Re:Things I’ve learned in my 20 years as a software engineer by boffinAudio on Friday October 08, 2021 @07:38AM (#28798082)
Either option is fine, as long as your user agrees.
Re:Things I’ve learned in my 20 years as a software engineer by Jensson on Friday October 08, 2021 @07:47AM (#28798138)
You have more than one user. Some of them will want power, other will want ease of use. You can't satisfy everyone without making multiple products.
Re:Things I’ve learned in my 20 years as a software engineer by TeMPOraL on Friday October 08, 2021 @08:42AM (#28798546)
More than that, there may be a whole stack of software components between your API and your users. In this sense, quite a lot of software is written for computers and not other humans (or, your users are other software devs).

This is to say, "all software is written for humans" is too general to be useful - the important issues are all in the details.

Re:Things I’ve learned in my 20 years as a software engineer by Aeolun on Friday October 08, 2021 @07:09AM (#28797888)
Probably something to do with the computer not caring about that. If you constantly divide your time between someone that’s 100% logical, and someone that generally isn’t, you’re bound to get confused.
Re:Things I’ve learned in my 20 years as a software engineer by taneq on Friday October 08, 2021 @11:56AM (#28800661)
Gonna expand on this just a bit. Software isn't a product or a service. It's a tool. No end user cares what your stack looks like, they just want to click a button that solves their problem.

Nothing between "click button" and "problem solved" is your user's problem, they're all yours.

Re:Things I’ve learned in my 20 years as a software engineer by agumonkey on Friday October 08, 2021 @06:45PM (#28804984)
Very few recent programs i've seen were socially useful. Some might find comedy in this but the app my current gig uses:

- is un ergonomic and redundant (typing the same thing over and over, no keyboard shortcut jquery era procedural code)

- the overall design is useless, it produces libreoffice templates that takes ages to be badly filled

- secretaries go faster using fucking paper and filling everything by hand

- the application has all the data at hand but nobody has access to stats or complex queries, people have to also write down stats with stick marks on paper so the hierarchy knows what's going on

alas

Re:Things I’ve learned in my 20 years as a software engineer by Waterluvian on Friday October 08, 2021 @07:57AM (#28798214)
What do I do with this, though?

I think I get what it means but how do I act on it?

Re:Things I’ve learned in my 20 years as a software engineer by boffinAudio on Tuesday October 12, 2021 @04:02AM (#28837243)
Always keep the human in mind, whatever software you are righting. Its turtles all the way up to the human.
Re:Things I’ve learned in my 20 years as a software engineer by DrBazza on Friday October 08, 2021 @07:59AM (#28798221)
Is this meant to be "code is for the reader, not the compiler", or "people are the ultimate end users of your software"?
Re:Things I’ve learned in my 20 years as a software engineer by jeffwask on Friday October 08, 2021 @10:04AM (#28799418)
20+ years and I concur.

Improvements in my "soft skills" have carried me further than any technical learning.

Re:Things I’ve learned in my 20 years as a software engineer by JohnL4 on Friday October 08, 2021 @11:20AM (#28800258)
A corollary-ish observation of my own:

   * If coders could write useful documentation (starting w/inline comments) they probably wouldn't be coders.
Re:Things I’ve learned in my 20 years as a software engineer by michaelmdresser on Friday October 08, 2021 @11:26AM (#28800319)
What would they be instead?
Re:Things I’ve learned in my 20 years as a software engineer by JohnL4 on Saturday October 09, 2021 @11:17AM (#28810584)
Communicators. (Writers, marketers, teachers, ...)
Re:Things I’ve learned in my 20 years as a software engineer by cutemonster on Saturday October 09, 2021 @05:58PM (#28813681)
Then they'd make less money.

Why would they choose less money

(Unless of course if they like those other jobs better)

Re:Things I’ve learned in my 20 years as a software engineer by jnaddef on Friday October 08, 2021 @11:26AM (#28800320)
They would be what then?
Re:Things I’ve learned in my 20 years as a software engineer by gjvnq on Friday October 08, 2021 @09:40AM (#28799177)
> Incredibly, it doesn't matter how educated the developer, they still seem to have to learn this lesson themselves, over and over, until it sinks in...

That's probably because many devs were socially isolated when growing up. (How do you think they got so much time spent tinkering with computers?)

Also, it is generally hard to imagine yourself in other's shoes. Example: imagine trying to use your UI but with a 60-year old vision instead of that of a 20-yo. Example: imagine having no formal address or no citizenship (stateless).

Re:Things I’ve learned in my 20 years as a software engineer by hungryforcodes on Friday October 08, 2021 @09:47AM (#28799252)
I fully agree with this.
Re:Things I’ve learned in my 20 years as a software engineer by zanethomas on Friday October 08, 2021 @09:23AM (#28798973)
another 40+ here w0rd!
Re:Things I’ve learned in my 20 years as a software engineer by xwdv on Friday October 08, 2021 @06:38AM (#28797712)
Isn’t this true of basically any job?
Re:Things I’ve learned in my 20 years as a software engineer by boffinAudio on Friday October 08, 2021 @06:40AM (#28797724)
Sure, but that doesn't make it any less useful as a fact - especially when you are working with other developers who choose to try to ignore/avoid it as a maxim.

Please don't tell me you've never met such a developer ..

Re:Things I’ve learned in my 20 years as a software engineer by xwdv on Friday October 08, 2021 @07:01AM (#28797838)
I am such a developer.
Re:Things I’ve learned in my 20 years as a software engineer by boffinAudio on Friday October 08, 2021 @07:16AM (#28797932)
See you in 30+ years! :P
Re:Things I’ve learned in my 20 years as a software engineer by Annatar on Friday October 08, 2021 @06:57AM (#28797805)
I reached quite the opposite conclusion: the purpose of software is to make a computer do work. Then again, I purposely refrain from writing end-user software and focus on backend automation. It is a deliberate choice.
Re:Things I’ve learned in my 20 years as a software engineer by koonsolo on Friday October 08, 2021 @07:05AM (#28797860)
Do you keep your code human readable? Why?
Re:Things I’ve learned in my 20 years as a software engineer by grog454 on Saturday October 09, 2021 @02:13AM (#28807475)
Just playing devil's advocate:

So I or someone else can continue to effectively make the computer do work.

Re:Things I’ve learned in my 20 years as a software engineer by koonsolo on Saturday October 09, 2021 @05:33AM (#28808308)
So it's a social act to keep the computer running.
Re:Things I’ve learned in my 20 years as a software engineer by boffinAudio on Friday October 08, 2021 @07:00AM (#28797824)
For whom does the computer do work?
Re:Things I’ve learned in my 20 years as a software engineer by pbourke on Friday October 08, 2021 @07:05AM (#28797857)
Other computers
Re:Things I’ve learned in my 20 years as a software engineer by Aeolun on Friday October 08, 2021 @07:10AM (#28797898)
I see you work in finance. Where the humans are just office decoration.
Re:Things I’ve learned in my 20 years as a software engineer by boffinAudio on Friday October 08, 2021 @07:14AM (#28797920)
It may be computers all the way down, but at the bottom there is a human. Somewhere. Poor thing.
Re:Things I’ve learned in my 20 years as a software engineer by kiklion on Friday October 08, 2021 @08:49AM (#28798615)
Unless it’s consumed by an AI. Which I don’t fully understand but am comfortable assuming that the AI might be able to ‘teach’ itself to consume an API.