discuss-gnuradio
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Discuss-gnuradio] How to contribute to GNU Radio in 5 mins or less per


From: Martin Braun
Subject: [Discuss-gnuradio] How to contribute to GNU Radio in 5 mins or less per day!
Date: Sun, 19 Mar 2017 22:54:43 -0700
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.7.0

You know those fake diet ads? Well, this is legit:

Have you ever thought, hey, I'd like to contribute to GNU Radio, but I
really don't have a lot of time? What if you could contribute in only a
few minutes per day, week, or month? Well, you can!

As you know, we've recently moved our wiki to https://wiki.gnuradio.org.
During the move, two not-so-good thing occurred:

1) Some of the autoimported pages from Redmine were borked during the
import. The conversion from Textile to MediaWiki format wasn't flawless.
In some cases, only small things went wrong. In others, entire sections
no longer made sense.

2) We realized (again) that there's still a lot of cruft on our wiki. A
lot of pages were culled during the move (on purpose), but sometimes
it's small subsections of pages that are now out-of-date.

The solution to both of these problems is: We need people to look at it.
But, per page, that can be done in only a few minutes.

So, here's my suggestion: How about YOU, dear potential contributor,
make this your start page:

https://wiki.gnuradio.org/index.php/Special:Random

Or find some other way to randomly check out a wiki page. There's even a
hotkey: Alt-Shift-x.

With many eyes, this is an easily solvable issue.

Now, when browsing pages, these are things to watch out for:

- Were HTML entities translated where they shouldn't? E.g., do you see
code like this: d_foo->method(), which should read d_foo->method() ?
- Does it make sense to rename the page? Redmine used page titles as
IDs, whereas MediaWiki actually uses the page title as the page title.
- Is syntax highlighting working properly? This page, for example, took
a lot of manual labour to fix:
https://wiki.gnuradio.org/index.php/Guided_Tutorial_GNU_Radio_in_C++
(and everytime I go back, I find more issues...)
- Is the content actually accurate?

Thanks everyone!

Cheers,
Martin



reply via email to

[Prev in Thread] Current Thread [Next in Thread]