Gentoo Archives: gentoo-dev

From: R0b0t1 <r030t1@×××××.com>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] [RFC] Reinstating old-school GLEPs masterplan
Date: Tue, 12 Sep 2017 02:59:44
Message-Id: CAAD4mYjNj2PrndwcatnyUAVuoZdrnEuNDQ4CK+vYRdNGF1SamQ@mail.gmail.com
In Reply to: Re: [gentoo-dev] [RFC] Reinstating old-school GLEPs masterplan by "Michał Górny"
1 Hello friends,
2
3 On Mon, Sep 11, 2017 at 3:56 PM, Michał Górny <mgorny@g.o> wrote:
4 > W dniu pon, 11.09.2017 o godzinie 13∶29 -0400, użytkownik Michael
5 > Orlitzky napisał:
6 >> On 09/11/2017 01:08 PM, Michał Górny wrote:
7 >> > Hi,
8 >> >
9 >> > TL;DR: I'd like to reinstate the old-school GLEPs in .rst files rather
10 >> > than Wiki, put in a nice git repo.
11 >> >
12 >>
13 >> I generally agree with you that wiki markup is terrible and that a text
14 >> editor and a git repo is The Right Way to do things (with Jekyll or
15 >> whatever to push it to the web). But in my experience, crappy and easy
16 >> is a better way to get people to contribute. When I've taken wiki
17 >> documents and moved them into git repos, more often than not I become
18 >> the sole contributor, and otherwise-technical people just start emailing
19 >> me their contributions (which decrease greatly in frequency).
20 >
21 > [...]
22 >
23 > Then, you can just take www.gentoo.org and run it locally. It takes
24 > a little more effort but jekyll is really trivial to set up and run
25 > locally. Then you see it exactly how it's gonna look on g.o.
26 >
27
28 I previously suggested Gollum and think I should suggest it again.
29 Gollum provides features relevant to a Wiki setting including web
30 editing. It would not require pages be rewritten and can render
31 MediaWiki that is maintained in a Git repository. It should be all of
32 the positives with no negatives.
33
34 Please refer to a statement by a project contributor and the original
35 author: https://github.com/gollum/gollum/issues/712.
36
37 Respectfully,
38 R0b0t1

Replies

Subject Author
Re: [gentoo-dev] [RFC] Reinstating old-school GLEPs masterplan "Michał Górny" <mgorny@g.o>