newbie contribute

asked 2017-04-24 23:00:05 -0500

xxiane gravatar image

updated 2017-04-25 01:11:28 -0500

Hello all,

This is my first time jumping into opensource, and wanted some advice on how to get started.

I thought I would start with the easy stuff, like helping out with documentation. But searching issues in the repo, I came across many open issues in which someone opened two years ago, but no one's been responding since. My question is: how can I tell which issues are actually still valid? I can easily see two-year-old code getting outdated and no longer worth documenting as opposed to newer issues. Also, if this issue is still indeed worth working on, who would I contact, since no one on the list seems to be responding?

Also, I seem to have some trouble navigating the site. For starters, when I visited http://docs.opencv.org/, the layout looked so different from the rest of the site that I thought I was in the wrong place. Is this page still in use? I do have some experience with making websites. Do you think I could help with making some of the of the pages look prettier? By the way, would someone mind explaining the different headers on that page? (Nightly, Doxygen HTML, Sphinx HTML, and Javadoc HTML?)

Thanks in advance!

edit retag flag offensive close merge delete

Comments

hey, that's nice !

berak gravatar imageberak ( 2017-04-25 01:03:43 -0500 )edit
1

Actually, I wound up here: http://docs.opencv.org . Do you know if this this page still in use?

xxiane gravatar imagexxiane ( 2017-04-25 01:08:04 -0500 )edit

sure !

it's just, that outdated branches like 2.4 or 3.0beta are no more maintained

berak gravatar imageberak ( 2017-04-25 01:11:17 -0500 )edit

Can I ask why OpenCV uses so many different markdown languages? Is it just because it's opensource and everyone likes to contribute with their favorite one?

xxiane gravatar imagexxiane ( 2017-04-25 01:14:39 -0500 )edit

they were using sphinx before, but switched to doxygen a good year ago (easier to maintain) , so the older docs have a different design/layout.

berak gravatar imageberak ( 2017-04-25 01:19:10 -0500 )edit

sure, that's still a valid issue. however, the "easy" tag might be a bit of a lie, since you would need to be familiar with the c++ codebase. (videostab also seems to be a "rarely used" module, so there's not many folks having experience with it) you can clearly see there, that some have tried, but they somehow got stuck ...

berak gravatar imageberak ( 2017-04-25 01:23:07 -0500 )edit

Well that's disheartening. So out of these that this site recommended, which ones would you suggest are actually doable for a newbie? https://github.com/opencv/opencv/issu...

xxiane gravatar imagexxiane ( 2017-04-25 01:26:10 -0500 )edit

thing with the real easy bugs is - they're gone quickly ;)

you might just watch the issues list (and also questions here, or hang out on #opencv) and be quick, if you're confident, you can solve it.

berak gravatar imageberak ( 2017-04-25 01:42:22 -0500 )edit

hey, here might be an easy one, that came up on irc yesterday: see minAreaRect : it's not "negative indices", but more like: the corners of the RotatedRect returned might lie outside of the image borders

berak gravatar imageberak ( 2017-04-25 01:45:47 -0500 )edit

Alright, thank you!

xxiane gravatar imagexxiane ( 2017-04-25 02:33:22 -0500 )edit