From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f41.google.com ([209.85.221.41]) by ewsd; Tue Jul 28 08:14:58 EDT 2020 Received: by mail-wr1-f41.google.com with SMTP id r12so18018770wrj.13 for <9front@9front.org>; Tue, 28 Jul 2020 05:14:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to; bh=M8LSzZpeAHae/Cs1DX12Rijhft7l3aQ8yFbYremrLmY=; b=t2laUFG3Y+Mrfx6KBT+An1aiqs+jkmWNDJFMviiZyDz8sSid+9M58M+kOXFPZjHera 2PaLx0IrqPWWe/0wrMP5MkgTCH36J8dASLiuvbwWhw6hCKDJdPZQyoQstRRXO4AL4OWG d1pUvqzYhJT7ahKSzDKoH56FHbbvGbFG3od5ylsStlMv8clFCKgHcVGaRkRIw5CJYRf0 jG6sanp7SnzLCjKwPxN5P8YnJwBZTaRFk5W1h3GBnh12GFQIloHmDyVwyLuEmz0BpZ7B /70PD4Ixx/VKixjB7LYsj/dTu752w83+iSu7wSWsPQwN31HFICU7ULgEGNAF2h4cMMgN zBJw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to; bh=M8LSzZpeAHae/Cs1DX12Rijhft7l3aQ8yFbYremrLmY=; b=HVyR5ijAL9YMv30DCfe/UM9CjjAGxc+cEskA5uHrgp9vy3h9JwNVBwtOOdQzosHDIo +kliv00NXbZYvZ7AsswvWlCeMFe4lP9P7IWQukmlkqtgG+o8Pqczr5/umi90xGVot9Sx bfwsDD79H/sxQzmmtObud4vGeib9DRQKg3t/ilz+1bxbV00+35ZiUiD7L4hX9KKIEUX0 6mQ1awPC4WPbGFWWcksI8QlJnrLuaYajOa5epCXsSm/ID8dYEwPW79BoymbLSUyBhI75 C1W8aPnJjiFaeZzxu53vYaSkCka+anCH1ZUuR/KRqF1YxIPxLUl/7vnYVyEAqfQCo4EV IrsQ== X-Gm-Message-State: AOAM530N7ZIEbDnrXMeMSlmu6cbVKL9dqAOjdZHM2EUPhbh6rxyWjRyA 0BtyMlzGp+7/N794/0l/L0kgK1Y8pYJgjN5mUpgHF8N2 X-Google-Smtp-Source: ABdhPJzkzC27lP9cDB2RUdL2cdATY3yKQUJ8cShXfRV7OCb1BQQ68Xb//U4vstNyhw5iGN8jkcj/ObgkZ2ElrBkiAQc= X-Received: by 2002:adf:ab0d:: with SMTP id q13mr23528135wrc.134.1595938494537; Tue, 28 Jul 2020 05:14:54 -0700 (PDT) MIME-Version: 1.0 Received: by 2002:adf:fd51:0:0:0:0:0 with HTTP; Tue, 28 Jul 2020 05:14:53 -0700 (PDT) In-Reply-To: <69ca4492-7a1f-48fb-ba59-4f226277042c@sirjofri.de> References: <97186701FFF3C64903FE2A1834258976@eigenstate.org> <24b4c44a-2ced-4b14-bd0f-e1dba93a597f@sirjofri.de> <69ca4492-7a1f-48fb-ba59-4f226277042c@sirjofri.de> From: hiro <23hiro@gmail.com> Date: Tue, 28 Jul 2020 14:14:53 +0200 Message-ID: Subject: Re: [9front] The 9 Documentation Project To: 9front@9front.org Content-Type: text/plain; charset="UTF-8" List-ID: <9front.9front.org> List-Help: X-Glyph: ➈ X-Bullshit: distributed module injection DOM-based backend it seems to me we might profit from making you boss of documentation, and whatever process you find will just have to become mandatory for the rest of us. sounds like you are also providing useful reasoning why your process is the right one and i'm happy to try and adopt it. On 7/28/20, sirjofri+ml-9front@sirjofri.de wrote: > Hello, > > the project is not only about creating a wiki space, this is just one part > that's especially useful for the information that's distributed over many > blogs or hidden behind long chat logs. I often find myself interviewing > kvik, burnzez or mycroftiv (and others) about how to do things that are > never written anywhere else. Most of the time I try to understand this and > then write an article about exactly that (on my personal blog or on > 9gridchan wiki). Imo this information is good in a wiki, because other users > can easily add missing information and link to other sources. > > The other parts of the project (if you want to call it like that) are: > improving man pages, fqa and maybe even debug messages. These are all more > static because there's a review and merge process. On the other hand, > collected information in a wiki can help authors to select content for the > fqa. > > Also don't forget /sys/doc and maybe /sys/lib/wiki. /sys/doc is a possible > place to be extended with updated information. The dead /sys/lib/wiki can be > revived with snapshots from the wiki. I can also think about a separate > update process that automatically fetches data from the wiki and includes it > into the system wiki (offline snapshot). > > You see, there are many possibilities and I'd like to provide a place where > plan9 users can provide useful information (guides, notes etc) that do not > fit in the book styled fqa or the highly implementation specific manpages or > the highly technical /sys/doc, also these articles can change quickly > (sometimes daily or weekly) which would be a lot for reviewers to approve > before including it into the main distribution. > > Also I don't expect things to be so complex. Having a plan9 usable small and > simple system (eg an official wikifs) makes more sense than hiding > everything in a browser that can't even edit the pages because there's too > much webshit or something like that. Also we are a small community, so > providing information should be more in focus than providing nice UI and a > modern web browsing experience. > > sirjofri > >