Thread (6 messages) 6 messages, 3 authors, 2021-10-29

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? :)
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help