2009-05-18, 02:47
xnappo Wrote:Most of the time, when someone reports a bug, the devs say 'Try the latest SVN'. Althekiller thinks the Olympia's install guide doesn't explain enough about 'why' you are doing a step. theuni thinks that experienced users shouldn't need a guide.
This all boils down to:
Olympia's guide was very useful for experienced users!!
xnappo
Documentation is always useful no matter how obscure it may be or simplistic it may seem. I use to never create any documentation and would store it all in my head. And it always came back to bite me later on. Now anything that I've previously fixed or found a way around it, I make sure it is written down. So anything that at least one person may find useful should always be kept. You should never assume that because one person understands it, everyone automatically does.
I know with programmers that if they are currently working on a project, everything can be in their head. But if they come back to that project years later, and there was no documentation, it will seem like a mess. And any documentation even if it's not useful to you at the time, should always be documented.
Also, the guide was questioned many times by the xbmc dev's on what needed to be changed to make it better. What should be taken out, etc. But no response was ever given except for its complete removal. The problem at the time was that Ubuntu's 8.04 and 8.10's version of alsa did not work with xbmc. It had to be upgraded. Those versions were also never going to get a newer version of alsa, so the claim of it breaking apt-get is false.
I had given a suggestion to instead of downloading scripts, put the contents of them in a code window:
Quote:like this
But that wasn't carried out either. I myself couldn't do that because I wasn't allowed to edit the wiki entry. So I could only make suggestions to improve it but even then the xbmc dev's didn't like that either it seems.