Live data from Hacker News

Ask HN: How do technical non-developers help with open source projects?

news.ycombinator.com

11–20 of 93 posts

Re: Ask HN: How do technical non-developers help with open source projects?

#11
Charles here, Community Manager at Sourcegraph (https://sourcegraph.com/). I'm not a developer.

Working with a developer community as a non-dev has taught me a lot. Earlier this year we started an open-source hacker meetup to give authors the chance to come talk about their projects at our office in SF.

To build this program, I help identify authors of open-source projects and invite them to speak at our meetups. While I don't code, I look for the most passionate contributors and try to give them a place to share what it's like maintaining, marketing, and building large projects. These talks are recorded and posted to YouTube where other programmers can hear lessons and challenges from their experience. Example here: https://youtu.be/ScUIlbHnxGI

In essence, open-source projects suffer from a lack of awareness and rely on manual exposure. If you can help open-source projects market themselves, find new contributors, and simplify their message, like nowarninglabel talked about with OpenBazzar, then they have a better chance of being picked up by the community.

Re: Ask HN: How do technical non-developers help with open source projects?

#12

For many projects, the single biggest hurdle to success/adoption is good, understandable documentation. Many (perhaps most) open source projects have technical capabilities far in excess of their usable docs. ("Read the whole wiki and then the whole discussion forum to understand" is a huge hurdle for new users.)

> ("Read the whole wiki and then the whole discussion forum to understand" is a huge hurdle for new users.)

Look, all you had to do was search for the forums for the the feature that you don't know the name of because it's not properly documented! I don't see the problem here.

Seriously though, documentation is a big deal. Both the "getting started" intro stuff, and the gritty details of more advanced features.

Re: Ask HN: How do technical non-developers help with open source projects?

#15
Accessibility, accessibility, accessibility.

Are there

- Link skips

- Dyslexia-friendly typography (no justification, no hyphens, preferably fonts with distinct glyphs)

- A colour scheme useable and legible to the huge population of colour-blind people

- Screenreader-friendly HTML

- Closed caption for video - or just transcripts

A lot of fancy-pants projects are absolutely amateurish when it comes to this, and it only really gets their attention, when their JavaScript-only project is penalized by Google's search ranking.

Re: Ask HN: How do technical non-developers help with open source projects?

#17
post #3

I'm also a technical product manager and have struggled with this question too. I have also wondered the same thing in the startup context: is there a good role for me in a <10 person startup, <5 person startup?

> is there a good role for me in a IMHO, very rarely. At such a small startup, a founder or co-founder is going to be the effective product manager.

Re: Ask HN: How do technical non-developers help with open source projects?

#18
Yes! Most Open Source projects were started by coders. Many coders (certainly not all, but many) are either bad at, or bored by, the stuff you've mentioned.

Documentation is often the Achilles heel of Open Source software, so having that ability (specifically "explaining new technology to customers" and "simplifying technical issues for customers") is incredibly valuable.

UI is also often weak and bolted on over time, to a degree almost never seen in well-funded proprietary software. So having wireframe/mockup sessions with OSS projects to sort out their UI weaknesses and maybe consolidate UI elements and make it more coherent to non-technical users would be of immeasurable value.

I say all of these things with the experience provided by the Open Source projects I work on (Webmin/Virtualmin/Cloudmin/Usermin), which have about a million users...but, our UI kinda stinks in a lot of ways especially because it has accreted rather than been designed, our documentation always trails the project (less so for Virtualmin and Cloudmin since we have some money for these projects as they are also commercial, but still a problem), and we never have nearly enough hands to help resolve those problems.

While there are Open Source projects that are insular and closed off (and many that don't want to be might look like they are, just due to not having anyone welcoming and marshaling volunteers, but they probably still want help), most will welcome your input as long as it is well-meaning and exhibits some desire to learn and teach. If you spend a week with almost any Open Source project and don't see areas that need some attention in the areas you've mentioned, I'd be surprised. And, spending a week (or so) with a project is probably the minimum you need to get an idea about the culture and to know where your input would be welcomed.

In short: Do it. There is need for anyone willing to help on most big and small Open Source projects. You'll learn a lot, get a great addition to your resume, and you'll probably make some new weird friends. Most OSS projects won't beg for help, even if they need it desperately...but, it doesn't mean they won't be happy to see you. They're making Open Source software because they want people to use it (usually), so, when you use it and especially when you help make it better, you're doing them a favor, and most will take it that way, even if you aren't super productive at the start.

Re: Ask HN: How do technical non-developers help with open source projects?

#19
Hyperboria / Project Meshnet are definitely in need of technical writing :)

We've been building a routing protocol (cjdns) and accompanying software for desktops, servers, phones, and home routers.

> Cjdns implements an encrypted IPv6 network using public-key cryptography for address allocation and a distributed hash table for routing. This provides near-zero-configuration networking, and prevents many of the security and scalability issues that plague existing networks.

I'm larsg in #cjdns on EFnet IRC in case you wanna hear more.

Re: Ask HN: How do technical non-developers help with open source projects?

#20
I'm a non developer working on the MySQL team.

One of the ways that I try to help is by collecting feedback from our community of users and passing it back to the developers.

Some examples:

http://www.tocker.ca/2015/01/05/what-defaults-would-you-like...

http://www.tocker.ca/2015/02/24/proposal-to-change-additiona...

Post reply on HN