Re: btrfs.wiki.k.org and git-based update workflow
From: David Sterba <hidden>
Date: 2021-10-25 14:09:37
On Fri, Oct 22, 2021 at 06:36:33PM +0200, Diego Calleja wrote:
El viernes, 22 de octubre de 2021 16:12:00 (CEST) David Sterba escribió:quoted
Current status is quite unpleasant, the number of active editors is 1 (me), with other occasional contributions. I somehow feel that the wiki concept as community editing does not work, specifically for our wiki, or maybe in general, anymore.I would like to mention that I have tried to edit the wiki a couple of times along the years, and somehow I was not able to get an account, log in, or recover my account (if I ever created one). Perhaps it's just me and others can use it just fine.
There were problems with the accounts, some people did not receive the confirmation email. Otherwise there's some odd behaviour after login and editing pages it suddenly drops to some local account (shown as address 10.220.*) and page is not updated. Such things get annoying.
In any case, it's worth noticing that the ext4 and xfs wikis are in worse shape, but with the improvements to the kernel doc infrastructure, at least ext4 maintains some great documentation there instead of at the wiki (eg https://www.kernel.org/doc/html/latest/filesystems/ext4/index.html)
I think docs in kernel tree are not suitable for user documentation, so it's probably fine for some internal design docs or on-disk structure description, but otherwise I'd rather have something not connected to the kernel git tree, if not only because of the different release schedule and update path.
It is also worth noting that while the kernel wikis are not very active, lots of semi-official content are generated in other places (eg the arch wiki).
I'm aware of that and see it as a problem. One part is the 'official' and reliability level of the information. I've seen to much copy&paste from similar sources just repeating old and invalid advice, or mentioning bugs that have been fixed or some bad usecase suggestions that could do damage. The other part is that there _are_ active editors and people able to publish good docs, but how to lure them to edit the main community wiki? :)