this post was submitted on 29 Aug 2023
344 points (99.4% liked)

Open Source

31737 readers
239 users here now

All about open source! Feel free to ask questions, and share news, and interesting stuff!

Useful Links

Rules

Related Communities

Community icon from opensource.org, but we are not affiliated with them.

founded 5 years ago
MODERATORS
 

I'm not complaining, but I didn't realize how much work it was. It makes me really respect the people who do it on a regular basis.

For example:

  • You know how to use your software, but other people don't. So you need to write documentation.
  • You can just modify the source files, but it's impractical for everyone to do that. So you need to add a config file.
  • You can just drag the output files into place, but that's impractical for everyone to do. So you need to package it.
  • You trust yourself, but distro maintainers rightfully don't. So you need to package your source code and configure the package to compile it.
  • You will abide by your idea of how the software should be used, but other people might not. So you need to pick a license.

Sometimes I think there must be an easier way, but I can't think of any. I guess it probably gets easier with experience.

all 26 comments
sorted by: hot top controversial new old
[–] Zeth0s 56 points 1 year ago* (last edited 1 year ago) (3 children)

That's why engineers are, on average, paid more than researchers... And why research is such a nicer job.

Create robust and easy-to-use stuff is tough and you don't get much reward

[–] [email protected] 20 points 1 year ago* (last edited 1 year ago) (1 children)

But if anything goes wrong or doesn't work right, suddenly the users remember who deserves recognition

[–] Zeth0s 13 points 1 year ago

Not really, they'll complain, open an incident and tell engineers they "are amateur, my grandmother could do better"

[–] hyperreal 2 points 1 year ago
[–] pexavc 2 points 1 year ago* (last edited 1 year ago) (1 children)

I've been attempting to build systems to make this "robustness" redundant across all my works, but I always feel there's something more that I missed. I can't tell if this task is simply never-ending or I just lack the knowledge of covering all the dots from the get-go or both.

[–] DetectiveSanity 1 points 9 months ago

Those are signs of an ever evolving/improving mind! You continue to perfect your craft and as such your older self is less efficient, perfect and organised.

[–] [email protected] 36 points 1 year ago

I've seen a chart where software development complexity grows 3 times on each of these steps. For example:

  • implement a business logic: 1 day
  • cover with tests: 1 * 3 = 3 days
  • write documentation: 1 * 3 * 3 = 9 days
  • make it installable by other users: 1 * 3 * 3 * 3 = 27 days
[–] [email protected] 29 points 1 year ago (2 children)

This is basically the problem with "suckless" software summed up.

[–] [email protected] 10 points 1 year ago

Terrible name too

[–] zephyr 9 points 1 year ago

I'm not sure I'd call it a problem. In the end it's the developers' choice.

Btw, I think this applies in general to opinionated software. Suckless is just a subset of that.

[–] [email protected] 28 points 1 year ago

Even the step from one-off script to reusable code is a 1:3–10 rise in complexity, even without distribution. It’s really interesting how problems grow.

[–] [email protected] 27 points 1 year ago (1 children)

Documentation is very useful today (to clarify our thoughts on what is useful and what is not, what is in scope and what is not), and for our future selves.

Writing small bits of software made me appreciative of the work teams put on large pieces of infrastructure!

[–] thirdBreakfast 7 points 1 year ago

Hard agree on helping out your future self. I routinely drop a commands.md file in every project now, and dump any commands in there for creating the dev environment, the build step, any thoughts that might help when I come back in five years.

[–] Caboose12000 12 points 1 year ago* (last edited 1 year ago) (1 children)

I've never worked on an open source project before but what you're describing are all my favorite parts of working on my personal projects so far. lol maybe if I get an actually useful project idea I'll finally become an open source dev

[–] [email protected] 9 points 1 year ago

If you enjoy writing documentation, creating tests or handling packaging there is any number of open source projects out there that would love your help. If you see a project that interests you at all, get stuck in!

[–] [email protected] 9 points 1 year ago

That's nothing. You know what you need. Try figuring out what other people need. They usually don't know what is technically possible, what would be most helpful and how it should work.

[–] shiroininja 7 points 1 year ago

Yeah, when I released the alpha of my first open source app, boy I had a lot of work to do when I started getting feedback

[–] [email protected] 7 points 1 year ago

But maybe you personally don’t have to write the docs or packaging stuff; if you publish it as open source, others can have a go themselves! :)

[–] [email protected] 7 points 1 year ago (1 children)

I have so many projects that could be cool for someone else, but I just can't be bothered making them usable for others.

[–] [email protected] 5 points 1 year ago

I write config files for my own stuff I use FWIW but yeah you're right lol open-source software is much more work. Still it's rewarding though to be able to share your cool software with the world.

[–] [email protected] 4 points 1 year ago

If you use something like C# at least source management and packaging are being done for you by the development tools.

But yeah it needs to do something useful and one needs to know how to operate it. That doesn't go away.

[–] [email protected] 4 points 1 year ago* (last edited 1 year ago) (1 children)

For the first and second point however, I've learned that whatever the others don't know today, that'll be my state of lack of knowledge in a few months or years. Anything that isn't a one off script I generally document/comment because I've had some projects when I was young, and couldn't work in them after a few months of break because I didn't understand anything.

That's when I understood, that "others" is just me in a few months.

[–] [email protected] 3 points 1 year ago

Once, I searched for a very specific thing about my laptops power throtteling behaviour and found an reddit post with an answer to it. After reading it, I saw my own username next to it :D I seemingly dug down that rabbit hole a couple of months prior.

[–] [email protected] 3 points 1 year ago

Just so do it for you so it’s not a drag

How to compile & deploy

How to operate