Rockbox General > Rockbox General Discussion

Rockbox Development - Documentation

<< < (4/6) > >>

karashata:
One thing I don't see anyone else having mentioned is that, being that the wiki is what it is, if you see any obvious discrepancies between what the wiki states and the actuality of things, you're always free to fix it yourself, though it may not be a bad idea to check in the IRC channel first (or perhaps mention it in the appropriate forum) to make sure that the change is appropriate. Often times, especially with older wiki pages, people may tend to forget about them and not end up updating them to reflect more recent developments.

chrisjj:
> you're always free to fix it yourself, though it may not be a bad idea to
> check in the IRC channel first (or perhaps mention it in the appropriate forum)

Understood. I asked only because often "the appropriate forum" is one for documentation... and I saw no-one using any other.

> Often times, especially with older wiki pages, people may tend to forget about
> them and not end up updating them to reflect more recent developments.

The "who didn't do the washing up?" problem :)

One solution is assigning responsibility.

Llorean:
Then I assign responsibility to you.

Seriously, it's a volunteer project, which means nobody has any enforcement ability. So, that's about as far as "assigning responsibility" can go. If you don't keep the wiki up to date, I guess we'll have seen how well the idea of assigning responsibility worked.

And as I told you before, "the appropriate forum" isn't one for documentation - it's the one for discussion of whatever the documentation was about. This shouldn't need repeating to you.

If you think the manual is bad, and it's in the section about controls, ask questions in the "user interface and voice" part of the forum. Then, if you satisfy yourself that the manual is incorrect, post a bug report in the tracker. It's pretty simple, and I don't see why you can't get a grasp on this.

Documentation is always about something. So discussion of the documentation about X is really discussion of X as well, and can go in that forum.

Can you think of a specific example of our documentation where there's not a subforum relevant to the documentation's subject? If there really is such a blind spot I'm sure discussion about opening up a relevant forum can be had.

karashata:

--- Quote from: chrisjj on April 28, 2010, 02:26:43 PM ---
One solution is assigning responsibility.


--- End quote ---

Actually, that's not really possible. No one person can be expected to know every aspect of the project, since it's actually quite extensive. The only real option is to have people like you either alert others to the discrepancies (either in the IRC channel or the appropriate subforum pertaining to the nature of the wiki article or manual entry in question), or to have people update the wiki themselves if they're sure of the changes being made.

As Llorean said, this is a volunteer project. No one can assign anyone to do anything. Even the developers aren't assigned anything specific, they work on whatever they have knowledge or interest in working on and go with it. I wouldn't be surprised if a lot of the developers have learned new things by working on this project that they wouldn't have learned otherwise in their jobs. (But that's starting to get a little off topic, so we won't go further there...)

Confuseling:

--- Quote from: karashata on April 28, 2010, 02:52:05 PM ---As Llorean said, this is a volunteer project. No one can assign anyone to do anything.
...
--- End quote ---

I suppose that isn't strictly true - Debian, for example, is a volunteer project with (some) clearly defined areas of responsibility.

But Rockbox isn't Debian.

The thing that seems bizarre about this is that for an open source project, the Rockbox documentation is actually very well maintained... or at least the bits that I've looked at are.

@ chrisjj: he who pays the piper calls the tune.

The Rockbox devs, I am guessing, partly release their code out of self-interest; by collaborating with others, they receive reciprocal collaboration, and get better software than they could possibly write themselves. They also, I am guessing, partly release their code out of sheer desire to make something publicly useful.

You'll notice you and I don't do anything in this arrangement. The way it works - convention has it - is that they owe us nothing, and we try not to seem demanding in return...

Navigation

[0] Message Index

[#] Next page

[*] Previous page