Using GitHub is a skill of it's own, and requires knowledge of coding practices. It's hugely confronting to someone without coding experience
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
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.
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.
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.
I absolutely agree. This needs to get a lot better. But talking about this will facilitate change. Thanks for taking part.
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.
Because UX/UI is just as painful as coding.
Fair enough but writing a readme isn‘t, right?
That's the most painful part of all.
Asking for a friend: do you code? Because most coders say this and thats my initial point. :)
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.
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.
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.
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.
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.
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.
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.
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.
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.
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
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.
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.
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.
Exactly. Thanks for mentioning it. :)
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.
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.
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.
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.
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? 😉
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.
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?
You got it! This is how we actually beat the corpo trash. :)
Considering how often feedback is met with "where's the PR"... that's why.
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?
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.
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.
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.
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.
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.
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.
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.
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 )
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.
Asklemmy
A loosely moderated place to ask open-ended questions
If your post meets the following criteria, it's welcome here!
- Open-ended question
- 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.
- Not regarding using or support for Lemmy: context, see the list of support communities and tools for finding communities below
- Not ad nauseam inducing: please make sure it is a question that would be new to most members
- An actual topic of discussion
Looking for support?
Looking for a community?
- Lemmyverse: community search
- sub.rehab: maps old subreddits to fediverse options, marks official as such
- !lemmy411@lemmy.ca: a community for finding communities
~Icon~ ~by~ ~@Double_A@discuss.tchncs.de~