CONTRIBUTING.rst 2.48 KB
Newer Older
A. Wilcox's avatar
A. Wilcox committed
1
2
3
4
5
6
7
8
9
10
========================================
 Contribution Guide for Project Horizon
========================================
:Author:
  * **A. Wilcox**, documentation writer
:Copyright:
  © 2015-2019 Adélie Linux Team.  NCSA open source licence.



A. Wilcox's avatar
A. Wilcox committed
11
12
13
14
15
16
17
18
19
20
Code Style
==========

See the `Code Style Guide`_ for information about the code style used in
Project Horizon.

.. _`Code Style Guide`: devel/STYLE.rst



A. Wilcox's avatar
A. Wilcox committed
21
22
23
24
25
26
27
28
29
30
Tests
=====

Please ensure that any feature additions include adequate testing.  The
overall goal for the Horizon repository is 100% test coverage for Runtime
Environment code, and 80% test coverage for Install Environment code.

Bug fixes may include regression tests to ensure the bug does not recur.


A. Wilcox's avatar
A. Wilcox committed
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

Contributing Changes
====================

This section describes the usual flows of contribution to this repository.
For a detailed description of how to contribute to Adélie Linux, review the
Handbook_.

.. _Handbook: https://help.adelielinux.org/html/devel/


GitLab Pull Requests
````````````````````

#. If you do not already have a GitLab account, you must create one.

#. Create a *fork* of the Horizon repository.  For more information, consult
   the GitLab online documentation.

#. Clone your forked repository to your computer.

#. Make your changes.

#. Test your changes to ensure they are correct.

#. Add (or remove) changed files using ``git add`` and ``git rm``.

#. Commit your changes to the tree using the commands ``git commit -S`` and
   ``git push``.

#. Visit your forked repository in a Web browser.

#. Choose the *Create Pull Request* button.

#. Review your changes to ensure they are correct, and then submit the form.


Mailing List
````````````

#. Clone the Horizon repository to your computer.

#. Make your changes.

#. Test your changes to ensure they are correct.

#. Add (or remove) changed files using ``git add`` and ``git rm``.

#. Commit your changes to the tree using the command ``git commit -S``.

#. Use the command ``git format-patch HEAD^`` to create a patch file for your
   commit.

   .. note:: If you have made multiple commits to the tree, you will need to
             add an additional ^ for each commit you have made.  For example,
             if you have made three commits, you will use the command
             ``git format-patch HEAD^^^``.

#. Email the resulting patch to the mailing list, using ``git send-email`` or
   your mail client.  Ensure you are subscribed_ first.

.. _subscribed: https://lists.adelielinux.org/postorius/lists/horizon.lists.adelielinux.org/