Re: [opensuse-wiki] Why is this acceptable?

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