Optimized for Fire TV
Fri, 27 Jul 2018 23:28:01 +0000
Kodi's GitHub codebase new face and better documentation
Every software developer knows that keeping code documentation up-to-date is difficult and time consuming, specially if code in need of said documentation is changing fast. Like, Flash fast. Among code documentation, the process of compiling the code is probably the poorest of cousins. After all, developers do know how to compile the software they write and writing documentation is not as glamorous as writing code. Given a choice, developers will always choose the latter over the former.
Though that was not Kodi's case, for years our build guides were spread between Kodi's Wiki and GitHub, generating confusion. To make matters worse, guides were often contradicting, not kept up-to-date and generally lacking in detail. To solve this predicament, we decided that Kodi's build guides should be kept alongside the code, where developers can easily update them when code changes.
Writing build guides might seem simple. It isn't. On one hand, people writing the guides are usually very comfortable with the process and tend to forget small but crucial steps. On the other hand, guides must be written taking the average user into account, not the seasoned developer. Let's not forget that the word "compiling" intimidates a lot of users, novice and seasoned alike and, as with many things in life, they seem utterly scary until you try. Once you know how to do them, they become an extremely easy and fun process. Most times, anyway.
That led to a conclusion: guides must not contain any ambiguity or room for interpretation. Plain spoon-fed copy and paste was the target. The result is a bunch of build guides for most common platforms and OSes Kodi runs on. Those include Android, FreeBSD, iOS, macOS, RaspberryPi, Windows and a general Linux guide. Popular Linux distributions among Kodi users, like Fedora, Ubuntu and openSUSE also have dedicated guides.
[ More ]
[ Read Full Story ]
Story found on https://kodi.tv/feed/