0005-guidelines-repository.rst 1.85 KB
Newer Older
Filipe Laíns's avatar
Filipe Laíns committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
==========================================
Move distribution guidelines to a Git repo
==========================================

- Date proposed: 2021-08-13
- RFC MR: https://gitlab.archlinux.org/archlinux/rfcs/-/merge_requests/0005

Summary
-------

Put distribution guidlelines in a Git repository and enforece a review process.

Motivation
----------

Currently, distribution guidelines (packaging guidelines, etc.) are in the Arch
Wiki. As the Arch Wiki is open to the public for edits, anyone can change the
guidelines. Having the guidelines in this format fuments lack of discussion, as
there is no review process enforced. Review is solely based on people watching
the wiki page and noticing changes. This results in low-quality and inconsistent
guidelines. Lastly, the discussion process (via the wiki talk page) is not very
friendly, which has surely demotivated/stopped people from contributing to the
discussions.

Specification
-------------

The guidelines in the Arch Wiki, should be moved to a new repository on our
Gitlab instance.

All changes must be reviewed by at least one Arch Linux staff member, other than
the author.

Large changes (changes that substancially change core of the guidelines) must
go through the RFC process.
Additionally, during the review of a guideline change, any Arch Linux staff may
request the discussion to be moved to the RFC process, and this request shall be
honored if it is backed by at least one other staff member.

Drawbacks
---------

Having the guidelines in a Gitlab repo and enforcing a review process will
higher the bar for contributions.

Unresolved Questions
--------------------

Should we have assigned reviewers for each guidelines?

Alternatives Considered
-----------------------

We could add a review process to the guidelines and still keep them in the Arch
Wiki, though I believe moving then to a Git repo is just easier.