On 09/08/2021 12.15, Stefan Seyfried wrote:
On 09.08.21 11:49, Carlos E. R. wrote:
On 08/08/2021 15.26, Stefan Seyfried wrote:
Until today, openSUSE was considered a do-ocracy (at least by me): those who *do*, decide. Apparently this is no longer considered a good idea.
Eum... The wiki is also a do-ocracy.
Here we have one do-acracy attempting to destroy another do-acracy. That's something for the community to decide upon, IMO.
Then what about changing from "Migrating wiki -> new docs" to "Importing wiki -> new docs".
The people who want the wiki can continue to contribute to the wikis, other people will contribute to the new docs. Sooner or later, users will vote with their clicks what documentation fits them best.
It might make "us" (openSUSE Project) look somewhat stupid and disorganized, but that's how we want to be, apparently, so it will properly represent the current state :-)
*If* during the import the "new docs" maintainers find that there is grossly inaccurate or outdated content in the Wiki, they could flag it as such. My personal experience with the Wiki is, that often the information I am looking for is outdated and no longer applies, or that pages are obviously abandoned and unmaintained. A coordinated effort during the import of "looking at all pages" might even benefit the remaining wiki users.
The same effort can be employed at updating the wiki, without creating dispersion. How do we know that the /imported/ articles will still be up to date in five years time? Will be the people updating one site be better at keeping information current that the other people? Why? I don't see why, unless they are a paid team to dedicate full time to writing docs. But in that case, it will happen that they have to explain stuff that they don't know about, and other people have to explain the stuff to them.
Disclaimer: I have not really looked at the wiki for quite some time for obvious reasons -- bad experience in the past. It might of course be all new and shiny today.
It is the same as static information sites. Some pages are current, some are not. Some are written by the developers or maintainers of the stuff they document, others are written by users of that stuff after experimenting with it, without first hand knowledge. For example, the pages I maintain I can only update for each release after I have migrated to the new release and verified the path, so the information is obsolete to the people going there faster than me. So there can be months of delay, even a few years. Will the distribution release be delayed while a documentation team tries and documents in full the new release? I don't think so. Even when obsolete, some pages are informative and of interest to people arriving later that don't know where to start. And perhaps those people can update those pages after getting their goal. On a static site, the barrier for those new people to write something is higher. -- Cheers / Saludos, Carlos E. R. (from oS Leap 15.2 x86_64 (Minas Tirith))