On 12/28/2016 03:10 AM, PatrickD Garvey wrote:
I do not understand decisions such as documented in https://en.opensuse.org/Icecream, "The documentation used to live in this page, but moved into a markdown README hosted under https://github.com/icecc/icecream. To report an issue or fix a problem, use github. You can fork the repo to edit the README.md just fine."
First of all, this is the first time I hear about Icecream and I don't know the developers. That been said, I perfectly understand they moved the documentation to Github. 1) Github is the platform where the real development of Icecream happens. It's simply natural for developers to use the same mechanisms (pull requests) and platform to maintain the documentation. 2) On the other hand, almost everybody on the open source (and/or free software) universe is using Github nowadays. Everybody who is in the position to help (developers and users) is used to Github and, most likely, has an account there. You don't need an openSUSE account to contribute documentation. 3) The content in Github is way more visible than the one at our wiki. The openSUSE wiki is kind of a niche that only we use (and that we are using less and less, IMHO). Try to search something in Google (or any other popular search engine) that is both in Github and in our wiki. The first one will be found and in a high position, for the latter I'm not so sure. In short, IMHO Github is the natural choice to keep the documentation of a software project. We shouldn't be surprised if people moves away from the openSUSE wiki for that purpose. Cheers. -- Ancor González Sosa YaST Team at SUSE Linux GmbH -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-wiki+owner@opensuse.org