Live data from Hacker News

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

news.ycombinator.com

21–30 of 93 posts

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

#22
Pretty much all projects can benefit from these kinds of skills. I'm a community manager and technical writer, and I make non-code contributions to open source projects. My process is something like this:

1) Find an open source thing that I use or think is interesting. This has included OpenStreetMap, LocalWiki, MediaWiki, an interactive map project at my former university, a tool my hacker/makerspace has built for itself, an educational website about open source, a tool made by the local Code for America brigade, etc. The important part is just that I like the thing.

2) Get in contact with the people - join the mailing list, IRC channel, forum, meetups, or whatever they use to communicate; look at the bug tracker and blog. Start learning about how the people work and what they're working on, and start asking and answering small questions, pretty much making friends with them in a low-key way. At this point you can probably tell whether they're reasonable people to talk to - if they're unfriendly or non-responsive, abandon ship.

3) Ask for suggestions for what to work on, and find tasks for yourself based on your expertise. Things will come up as needing improvement, and you can propose solutions to the group and start getting them done. For me, this can involve recognizing and filing bugs about user experience issues, improving website copy, writing marketing materials like social media posts and blog posts, organizing documentation, identifying holes in documentation that people have overlooked, and so on. This kind of non-technical work usually requires getting some amount of buy-in and trust from project collaborators, which is why step 2 is important.

4) Yay, you are now contributing useful things to a cool project.

I've written a little more about this as part of one of the projects I volunteer with, OpenHatch (https://openhatch.org/), an organization that helps people get involved with open source: http://blog.openhatch.org/2013/how-i-found-an-open-source-pr... + http://mergestories.com/s/improving-a-project-homepage/. The second post is from Merge Stories, our collection of posts where people explain how they made an open source contribution, to help give newcomers a realistic picture of what contributing looks like: http://mergestories.com/

This is also a helpful article: http://blog.smartbear.com/programming/14-ways-to-contribute-... - a list of ways to contribute to open source that aren't just writing a pile of code.

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

#23
post #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 onl…

As someone with (mild) dyslexia I didn't even realise there were people out there making friendly typography so I had a look around, e.g. dyslexie font [1] is a pretty cool read.

[1] http://www.dezeen.com/2014/11/09/christian-boer-dyslexie-typ...

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

#24
As a new-comer to open source projects recently, I found it was hard to get a handle on the 'roles' in a project. I was used to working on corporate, in-house technology projects where there are plenty of non-technical activities to perform (PM, Business Analyst, End-User testing/training, Governance, etc) - but it isn't obvious how those apply to most open-source projects, or even if they are required at all.

I found this link pretty useful to breakdown the activities and roles: http://oss-watch.ac.uk/resources/rolesinopensource

Like everyone else will say...first involvement is a bit nerve-wracking (How will people respond? Can I make a decent contribution? Will I look like a total noob?), but you'll only feel that way once.

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

#25
IMHO the most important non-technical thing for Open Source is evangelism. Talking them up on wikis, encouraging your employer to use them, helping answer questions on open forums... Relative to commercial projects, technical resources aren't the limiting factor.

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

#26
post #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 onl…

Yes! Thank you. Accessibility is much easier if you plan for it from the start and it's very important to have accessible content.

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

#27
Something I haven't seen mentioned yet: For a developer to become involved with a new project requires some substantial cognitive overhead to learn what files matter, the terminology and basic flow of data through the codebase, etc. There may be interest in having someone with your skillset create "Introduction to Hacking Foo" presentations. For example, if someone offered to tell me the main components of how django works in an easily accessible style with plenty of helpful visual accompaniments, I'd be thrilled. While I can figure those things out, that figuring takes time/reading/effort and anything that could potentially reduce that effort is just great IMO

If your content is good enough and you're passionate about such an idea, I could see a series of these introduction videos/slides/blog posts being a really popular series

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

#29
The biggest contribution that I can think of is spending quality time distilling the true value of a project into succinct, easy to understand, practical language and then (as a technical former-coder) building clear startup / path to use instructions.

Failing that - stand up the code base and help with the README?

I'd also second the gardening / community management effort. It's very important but I wouldn't get too general - keep up your technical / code chops so you can still truly distill things across all the audiences you need.

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

#30
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?

It depends how far you want to take the definition of what you do away from 'traditional' PM. At a ~10 person company chances are there are a lot of things that need doing around interfacing with users/customers, identifying beta testers, following up, triaging product feedback, writing great docs and content, writing sample code and SDKs, etc. Sometimes one of the founders does it, but as the company grows, that kind of day-to-day is hard for a founder to stay on top of if they have other areas of focus too.

It depends a lot on the kind of project the company is building, of course. A developer platform vs a consumer app will have a vastly different need for such things. I work at a 10 person developer-focused startup and as an ex-PM with engineering chops, I jump between building the product itself, working on developer-facing stuff, and randomly helping out. I definitely wouldn't call myself a product manager at the moment, though -- if you really want that as your job title then you probably need a slightly larger company where you can take the reins on product from the CEO, while the CEO switches to focusing on developing the company itself.

Post reply on HN