183

Disclaimer

Not trying to blame anyone here. I‘m just taking an idea I‘ve read and spinning it further:

Intro

A lot of people use free open source software (foss), Linux being one of them. But a lot less actually help make this software. If I ask them why, they always say „I don’t have the coding skills!“.

Maybe its worth pointing out that you don‘t need them. In a lot of cases it’s better to not have any so you can see stuff with a „consumer view“.

In that situation you can file issues on github and similar places. You can write descriptions that non technical people can understand. You can help translate and so on, all depending on your skills.

Other reasons?

I‘d really like to know so the foss community can talk about making it worthwile for non coders to participate.

top 50 comments
sorted by: hot top controversial new old
[-] ada 93 points 11 months ago

Using GitHub is a skill of it's own, and requires knowledge of coding practices. It's hugely confronting to someone without coding experience

[-] agent_flounder@lemmy.world 11 points 11 months ago

I code but I found it to have quite a learning curve.

Maybe the first step is to develop a "how to use git for improving documentation on a FOSS project" lol

[-] haui_lemmy@lemmy.giftedmc.com 9 points 11 months ago

Yes, absolutely but github (which is only an example, mind you) has a lot of consumer friendly accomodations like github gui and cli.

You can edit stuff directly in someone elses repo (or so it seems) in the web browser. I know you have to do a branch and a pull request but thats something that can be worked on.

[-] Paradachshund@lemmy.today 24 points 11 months ago

Since you're trying to build bridges with this post, I just want you to know that everything you mentioned in this comment is far beyond a non-programmer and sounds totally incomprehensible. It's jargon soup. I don't say this to dunk on you or anything, I just wanted to let you know how high your own skill level is, because it can be easy to forget sometimes. People without those skills won't be able to follow this kind of explanation.

load more comments (5 replies)
load more comments (6 replies)
[-] zeusbottom@sh.itjust.works 59 points 11 months ago

Tried submitting a relatively simple change to the Ansible code base once. Added an option to the telnet module to support different ports. Submitted a pull request. Was told I needed to change and update the documentation. Didn’t know how to do that, and I didn’t get any guidance, so I abandoned the pull request. Kept on using my own hack until someone else added the option.

Make contributing easy, and more people will contribute.

[-] haui_lemmy@lemmy.giftedmc.com 12 points 11 months ago

I absolutely agree. This needs to get a lot better. But talking about this will facilitate change. Thanks for taking part.

[-] sbv@sh.itjust.works 7 points 11 months ago

Pretty much this. I had a similar experience on a different project. If I ever submit a patch again, I'll make sure to run it by the maintainers before I start coding.

load more comments (2 replies)
[-] slazer2au@lemmy.world 37 points 11 months ago

Because UX/UI is just as painful as coding.

[-] haui_lemmy@lemmy.giftedmc.com 8 points 11 months ago

Fair enough but writing a readme isn‘t, right?

[-] grte@lemmy.ca 34 points 11 months ago

That's the most painful part of all.

[-] haui_lemmy@lemmy.giftedmc.com 5 points 11 months ago

Asking for a friend: do you code? Because most coders say this and thats my initial point. :)

[-] grte@lemmy.ca 8 points 11 months ago

I'm not a coder but I relate to being a lot more attracted to the idea of problem solving than writing a well-formed document that communicates ideas clearly, haha.

load more comments (1 replies)
[-] Carighan@lemmy.world 19 points 11 months ago

What use is a readme written by someone who doesn't know the code, doesn't know the internal designs, the design goals, the plans of the current maintainers, anything? It'd be no better than asking ChatGPT to write it for you.

[-] haui_lemmy@lemmy.giftedmc.com 6 points 11 months ago

I‘m sure a lot of people who correct text, add references, structure and pictures to a readme would disagree with you.

I‘m not sure if you‘re a coder but it you are, you should know that coding and usability are two entirely separate things.

[-] Carighan@lemmy.world 11 points 11 months ago

Oh...

You don't mean the readme file. You are talking about the manual, or the explanations on the website. Yeah that can make sense. Though I would still say it's weird if you're not too familiar with the direction the application is going, but an experienced user can of course help create better texts and pages for that.

[-] ItsComplicated@sh.itjust.works 8 points 11 months ago

Easy, just click the whatchamacallit, and add that little do-hicky!

load more comments (2 replies)
load more comments (5 replies)
[-] brygphilomena@lemmy.world 11 points 11 months ago

Technical Writer is a skill. It's a fairly well paid one too.

Being able to make good documentation is hard.

User Experience (UX), user interface (UI), and graphic design are all also surprisingly difficult. Much of which is integrally tied to the code.

load more comments (2 replies)
[-] not_a_bot_i_swear@lemmy.world 34 points 11 months ago

Because every time you try to suggest more modern interfaces you run into the type of people that like it when software looks utilitarian and bland.

[-] stealth_cookies@lemmy.ca 7 points 11 months ago

Seriously how many people have complained about how GIMP works and looks to the point where Gimpshop exists but they still haven't made any improvements.

load more comments (2 replies)
[-] cashews_best_nut@lemmy.world 34 points 11 months ago

I'm a programmer and I find dealing with other programmers frustrating and pointless if you discuss anything that's not programming related.

They'll happily discuss algorithms or language paradigms for hours but if you mention design, UI/X, marketing, etc they shut you down claiming some greater-technical reason for the feature.

Lemmy is a good, recent example. As part of being a web dev I've also done a lot of SEM. The devs have a Github issue for making readable URLs. They completely refused to consider it claiming other technical requirements for not allowing it. Any arguments outside the narrow technical reasons are discounted. So what if readable URLs will help people find the site through Google easier (because Google will better index the site). It breaks X feature and we don't see a need. No discussion and no listening.

If devs don't see a strict technical need for something they ignore it at best and at worst they insult you for being an idiot.

Hubris and ignorance make it a PITA to deal with them.

[-] haui_lemmy@lemmy.giftedmc.com 8 points 11 months ago

Ohhh I know that one! This happened to me a lot already. Some devs are completely socially incompetent although brillant programmers. I mostly call them out on their bs if they start it. Happened a couple times in this comment section alone.

[-] Daxtron2@startrek.website 5 points 11 months ago

This is why I'm so glad my degree forced us to have UI and UX classes to graduate. I definitely picked up a lot from those that have helped me be a better developer overall

[-] Candelestine@lemmy.world 31 points 11 months ago

If you give me an extremely easy way to submit feedback, then I will. Don't expect me to go way out of my way, though, researching how to get into contact with you and such. I don't actually care that much, you know how many products exist out there, right?

But, just by way of example, an early access game I started playing recently has a very convenient button in the main HUD for submitting bug reports/suggestions, and I've been considering different ideas to submit with it. Any I cannot throw out as impractical or counter-productive will get submitted eventually. I'll also report bugs I encounter, of course.

I will not look up your team's forums just to talk to you though.

[-] haui_lemmy@lemmy.giftedmc.com 7 points 11 months ago

Absolutely relatable. Thats why we need to make this a more streamlined process.

Like every foss software, be it games or whatever, should have an easy way to report bugs.

One thing I see different is foss-software and -games: You getting something for free and asking for „everything be dead easy“ without helping it become dead easy is not the most healthy.

You cant compare foss software with for profit software that either takes your money, serves you ads or outright sells your data. Thats only making the world a worse place.

The devs dont make money off you, yet you‘re saying you‘ll not give anything back except if they pave your way to it. I think you should pay for foss software then.

load more comments (8 replies)
load more comments (2 replies)
[-] dan@upvote.au 25 points 11 months ago* (last edited 11 months ago)

If you can't code (or have limited coding skill) but know the system well, one of the best ways to contribute is by writing end-user focused documentation. Write about things that confused you. Improve the "getting started" guide. Add more articles to the docs. Create video tutorials. Things like that.

[-] haui_lemmy@lemmy.giftedmc.com 5 points 11 months ago

Exactly. Thanks for mentioning it. :)

[-] chitak166@lemmy.world 24 points 11 months ago

I think a major deterrent from contributing things that aren't code is that whoever is implementing it might think their design is better just because it's theirs.

Try talking to the GNOME team, for example. You will never be able to get a suggestion past them because they're always right and you're always wrong.

Even when you prove them wrong and they backpedal, they are still correct and you are still wrong.

[-] LoKout@lemmy.world 15 points 11 months ago

I ran into basically this with home assistant. Commented on an issue about an integration to point out that it didn't work at all, and to support another user that had rewritten it in a way that fixed it. The approval dev jumped in to say that they only permit single changes to be approved. That's fine, I guess, but to fix the issue multiple changes were necessary. The user that had rewritten it then tried to limit the change to a single fix, but because that didn't resolve the issue they blocked the change. The integration still doesn't work and the user stopped trying to fix it.

[-] chitak166@lemmy.world 8 points 11 months ago

I totally believe you.

That kind of rigidity in software design leads me to believe more people need to read The Pragmatic Programmer.

I, of course, do not; because I am already a pragmatic programmer.

load more comments (1 replies)
load more comments (3 replies)
[-] TheGalacticVoid@lemm.ee 19 points 11 months ago

As someone who knows how to code and wants to contribute to FOSS, there is very little guidance in doing so even if I half-know what I'm doing.

load more comments (1 replies)
[-] jbrains@sh.itjust.works 15 points 11 months ago

Writing documentation of all kinds seems like it would help a great deal. I would be hesitant to file UX complaints, because those tend to be ignored by programmers who focus their limited available time on fixing defects and shipping features.

Where are all the programmers who enjoy improving UX and enjoy the challenge of changing legacy code? 😉

[-] haui_lemmy@lemmy.giftedmc.com 7 points 11 months ago

Fair enough. There seems to be a hole in the plan there. I think most UX programmers are sitting on their 5000$ chairs writing code on their 10k$ mac for their billion $ corporate employer. Kind of joking but I bet its not far from the truth.

[-] agent_flounder@lemmy.world 14 points 11 months ago

Some people are better at technical writing, some are better at coding, some better at UI/UX design

I don't think op is asking people with zero technical aptitude to jump in writing user manuals.

Just because you don't code doesn't mean you can't contribute in some fashion. If you have the skills to improve a user manual, wiki, or help file.... Why not right?

[-] haui_lemmy@lemmy.giftedmc.com 10 points 11 months ago

You got it! This is how we actually beat the corpo trash. :)

[-] amio@kbin.social 13 points 11 months ago

Considering how often feedback is met with "where's the PR"... that's why.

load more comments (3 replies)
[-] webjukebox@lemmy.world 12 points 11 months ago
load more comments (2 replies)
[-] z00s@lemmy.world 11 points 11 months ago

OP, your post has inspired me! I'm going to write a small python program that works as a multiple choice questionnaire that spits out a comprehensive 'contributing.MD' at the end of it.

When I'm done, will you test it for me and give some feedback?

load more comments (1 replies)
[-] CanadaPlus@futurology.today 8 points 11 months ago

An organised, easy way to do this would be great. Kind of like a test audience for FOSS.

Right now, people basically have to appoint and organise themselves as reviewer, which is a big ask.

load more comments (3 replies)
[-] MrFunnyMoustache@lemmy.ml 8 points 11 months ago

Making it easier to contribute is the main thing. I don't use git or discord, so I usually try to find an email address, if none is available I move on.

load more comments (1 replies)
[-] Broken_Monitor@lemmy.world 8 points 11 months ago

I think just spreading awareness is a step in the right direction. Most people I know just have no clue and continue purchasing the established mainstream programs. I encourage people to give GIMP a try instead of buying photoshop, or OfficeLibre instead of MSOffice. Most of them are ecstatic to save a couple hundred bucks. The more people that use FOSS software the more likely we are to get the support it needs.

load more comments (5 replies)
[-] echodot@feddit.uk 7 points 11 months ago

I think the biggest issue with this would be that it would require non-technical people to use ticketing systems (have you ever worked in admin IT?).

They tend to put things like, button broken, or will not load, which are not necessarily helpful tickets.

load more comments (1 replies)
[-] HikingVet@lemmy.ca 7 points 11 months ago

Because my skills when it comes to coding (absolutely none), is using the program until it breaks and telling someone what happened from an uneducated stand point.

If you are going to make things for "idiots" you need to hand it to "idiots" for testing.

load more comments (1 replies)
[-] BackOnMyBS@lemmy.world 7 points 11 months ago* (last edited 11 months ago)

I would be happy to give feedback, but I have no idea how to do so. On a few occasions, I have responded to posts, such as like on Lemmy where someone asked for suggestions to improve KDE. I still have no idea how to use GitHub at all, much less to provide feedback. I know GitHub is something I can work on to learn to interact with the FOSS development community, but it's probably a major barrier to the non-tech people that use FOSS.

Now that I think about it, I'm thinking it would increase non-tech interaction if developers of FOSS engaged the community through social media. Like, get on Lemmy, Mastodon, even Reddit, FB, and Instagram, and engage the community in these discussions. I think that will definitely increase engagement from the non-tech users, though some of those sites may feel like a betrayal of values. It seems like an interesting ethical dilemma.

Edit: So I looked into it for KDE in particular. They actually have a Wiki that simplifies user engagement. Maybe promoting these avenues will also help engagement.

load more comments (7 replies)
[-] CADmonkey@lemmy.world 6 points 11 months ago

I wish I or someone else who understands CAD modeling could help make FreeCAD work better. A LOT of the issue is tools that are commonly used are hidden in weird places that make sense only to people who don't used cad for a living.

load more comments (1 replies)
[-] AzureInfinity@leminal.space 5 points 11 months ago

I have to write userscripts to make websites bearable, software UI is not as customizable( bright white background at night, tiny 9pixel fonts, huge empty margins and content crammed into 200x200 boxes,lots of tiny cryptic icons crammed into toolbars that suppose to be menus,etc )

load more comments (1 replies)
[-] megane_kun@lemm.ee 5 points 11 months ago

It takes a certain kind of a skill set and experience to be able to translate this "consumer view" into something that can be acted upon by a developer.

Sure, the skill set can be developed, the knowledge (about software development, the available technologies, and having an idea of what is and isn't feasible in the first place) can be built up, and the experience (communicating with developers) can be accrued, but that really stops a lot of people from even thinking of contributing.

Perhaps a subset of the (open-source) community can help in developing these (skills, knowledge, experience) among interested people. Teach people how to look for issues, bugs, or come up with feature requests; teach them how to put these into a form that's easily understood and appreciated by the developers, and finally, teach them how to communicate with developers without losing the "non-techie user POV" which makes their feedback valuable in the first place.

IDK though, having read what I've just written, it seems to be quite a task.

load more comments (5 replies)
load more comments
view more: next ›
this post was submitted on 20 Dec 2023
183 points (100.0% liked)

Asklemmy

43898 readers
878 users here now

A loosely moderated place to ask open-ended questions

Search asklemmy 🔍

If your post meets the following criteria, it's welcome here!

  1. Open-ended question
  2. Not offensive: at this point, we do not have the bandwidth to moderate overtly political discussions. Assume best intent and be excellent to each other.
  3. Not regarding using or support for Lemmy: context, see the list of support communities and tools for finding communities below
  4. Not ad nauseam inducing: please make sure it is a question that would be new to most members
  5. An actual topic of discussion

Looking for support?

Looking for a community?

~Icon~ ~by~ ~@Double_A@discuss.tchncs.de~

founded 5 years ago
MODERATORS