You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+52-46Lines changed: 52 additions & 46 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,32 +5,34 @@
5
5
The following is a set of guidelines for contributing to LinuxGSM, which are hosted in the [GameServerManagers Organization](https://github.com/gameservermanagers) on GitHub. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
6
6
7
7
## Table of Contents
8
-
*[Contributing to LinuxGSM](#contributing-to-linuxgsm)
9
-
* [Table of Contents](#table-of-contents)
8
+
9
+
[Contributing to LinuxGSM](#contributing-to-linuxgsm)
*[Issue and Pull Request Labels](#issue-and-pull-request-labels)
35
+
34
36
## Code of Conduct
35
37
36
38
This project and everyone participating in it are governed by the [LinuxGSM Code of Conduct](https://github.com/GameServerManagers/linuxgsm/blob/master/CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behaviour to [[email protected]](mailto:[email protected]).
@@ -41,11 +43,11 @@ This project and everyone participating in it are governed by the [LinuxGSM Code
41
43
42
44
This section guides you through submitting a bug report for LinuxGSM. Following these guidelines help maintainers and the community understand your report 📝, reproduce the behaviour💻, and find any related reports 🔎.
43
45
44
-
Before creating bug reports, please check [this list](https://github.com/GameServerManagers/linuxgsm/blob/master/CONTRIBUTING.md#before-submitting-a-bug-report) as you might find out that you don’t need to create one. When you are creating a bug report, please [include as many details as possible](https://github.com/atom/atom/blob/master/CONTRIBUTING.md#how-do-i-submit-a-good-bug-report). Fill out [the required template](https://github.com/atom/.github/blob/master/.github/ISSUE_TEMPLATE/bug_report.md), the information it asks for helps us resolve issues faster.
46
+
Before creating bug reports, please check [this list](https://github.com/GameServerManagers/linuxgsm/blob/master/CONTRIBUTING.md#before-submitting-a-bug-report) as you might find out that you don’t need to create one. When you are creating a bug report, please [include as many details as possible](https://github.com/GameServerManagers/linuxgsm/blob/master/CONTRIBUTING.md#how-do-i-submit-a-good-bug-report). Fill out [the required template]([https://github.com/GameServerManagers/LinuxGSM/issues/new/choose](https://github.com/GameServerManagers/LinuxGSM/issues/new/choose)), the information it asks for helps us resolve issues faster.
45
47
46
48
#### Before Submitting A Bug Report
47
49
48
-
***Check the**[**documentation**](https://docs.linuxgsm.com/%5D(https://docs.linuxgsm.com/))**.** You might be able to find the cause of the problem and fix things yourself.
50
+
***Check the[documentation](https://docs.linuxgsm.com).** You might be able to find the cause of the problem and fix things yourself.
49
51
***Check that the problem is not related to**[**support page**](https://linuxgsm/com/support) for links to other support options.
50
52
***Check the**[**support page**](https://linuxgsm/com/support) for links to other support options.
51
53
***Perform a**[**cursory search**](https://github.com/search?q=org:GameServerManagers%20type:issues&type=Issues) to see if the problem has already been reported. If it has **and the issue is still open**, add a comment to the existing issue and give it a thumbs up instead of opening a new one.
@@ -83,19 +85,23 @@ Features are tracked as [GitHub issues](https://guides.github.com/features/issue
83
85
84
86
### 🎮 Game Server Requests
85
87
86
-
This section guides you through submitting a game server request for LinuxGSM, Following these guidelines help maintainers and the community understand your game server request 📝
87
-
88
+
This section guides you through submitting a game server request for LinuxGSM, Following these guidelines help maintainers and the community understand your game server request 📝.
88
89
#### Before Submitting a Game Server Request
89
90
90
-
***Check for existing**[**game server requests**](https://github.com/GameServerManagers/LinuxGSM/labels/type%3A%20game%20server%20request) to see if the new game server has already been suggested. If it has **and if the new game server is still open**, give it a thumbs up instead of opening a new one.
91
+
***Check for existing**[**game server requests**](https://github.com/GameServerManagers/LinuxGSM/labels/type%3A%20game%20server%20request) to see if the new game server has already been suggested. If it has **and if the new game server is still open**, give it a thumbs.
92
+
***Check the game server is supported on Linux**, this does not include Wine servers which we do not support.
93
+
#### How Do I Submit A (Good) Game Server Request?
94
+
* The title should be as follows: **[Server Request] Game Name**
95
+
***Provide Steam App ID** if applicable
96
+
***Supply any documentation/how-to guides** for the game server.
91
97
92
98
### 🎮 Game Server Specific Issues
93
99
94
100
LinuxGSM is a management script that acts as a wrapper around game servers. These game servers are developed by different game developers such as Valve, Epic and Facepunch to name a few.
95
101
96
-
LinuxGSM has no control over the development and limited knowledge issues directly relating to the game servers themselves. The same also applies for any mods, add-ons, maps etc.
102
+
LinuxGSM has no control over the development and limited knowledge of issues directly relating to the game servers themselves. The same also applies for any mods, add-ons, maps etc.
97
103
98
-
If there is an issue with a specific game server or mod the best action may be to contact the game/mod developers on there support forums. If it is unclear some community members might be able to help.
104
+
If there is an issue with a specific game server or mod the best action may be to contact the game/mod developers on there support forums. If it is unclear some community members should be able to help.
99
105
100
106
A [list](https://docs.linuxgsm.com/support/game-server) of known game developer forums is available on the [LinuxGSM docs](https://docs.linuxgsm.com/support/game-server).
101
107
@@ -112,7 +118,7 @@ The process described here has several goals:
112
118
113
119
Please follow these steps to have your contribution considered by the maintainers:
114
120
115
-
1. Follow all instructions in [the template](https://github.com/GameServerManagers/LinuxGSM/blob/master/.github/pull_request_template.md)
121
+
1. Follow all check-list in [the template](https://github.com/GameServerManagers/LinuxGSM/blob/master/.github/pull_request_template.md)
116
122
2. Follow the [style guides](#styleguides)
117
123
3. After you submit your pull request, verify that all [status checks](https://help.github.com/articles/about-status-checks/) are passing
118
124
@@ -130,32 +136,32 @@ If applied, this commit will _your subject line here_
130
136
131
137
For example:
132
138
133
-
* If applied, this commit will _refactor subsystem X for readability_
134
-
* If applied, this commit will _update getting started documentation_
135
-
* If applied, this commit will _remove deprecated methods_
136
-
* If applied, this commit will _release version 1.0.0_
137
-
* If applied, this commit will _merge pull request #123 from user/branch_
139
+
* If applied, this commit will **refactor subsystem X for readability**
140
+
* If applied, this commit will **update getting started documentation**
141
+
* If applied, this commit will **remove deprecated methods**
142
+
* If applied, this commit will **release version 1.0.0**
143
+
* If applied, this commit will **merge pull request #123 from user/branch**
138
144
139
145
Notice how this doesn’t work for the other non-imperative forms:
140
146
141
-
* If applied, this commit will _fixed bug with Y_
142
-
* If applied, this commit will _change the behaviour of X_
143
-
* If applied, this commit will _more fixes for broken stuff_
144
-
* If applied, this commit will _sweet new API methods_
147
+
* If applied, this commit will **fixed bug with Y**
148
+
* If applied, this commit will **change the behaviour of X**
149
+
* If applied, this commit will **more fixes for broken stuff**
150
+
* If applied, this commit will **sweet new API methods**
145
151
146
-
Below is an example of the subject line for a pull request.
152
+
Below is an example of the subject line for a pull request:
When a Pull Request is submitted, a series of status check tests are conducted. These tests will asses the code quality, complete CI tests etc. To get your PR merged these status checks must pass.
156
162
157
163
#### Test Environment
158
-
It is recommended that you have a testing environment available to test your code during development. To test your own cod you must change some variables within the `linuxgsm.sh` file. This will force the use of your own code branch.
164
+
It is recommended that you have a testing environment available to test your code during development. To test your own code you must change some variables within the `linuxgsm.sh` file. This will force the use of your own code branch.
159
165
```bash
160
166
## GitHub Branch Select
161
167
# Allows for the use of different function files
@@ -183,7 +189,7 @@ As well as code contributions it is possible to contribute by writing and improv
183
189
184
190
### Documentation Styleguide
185
191
186
-
LinuxGSM has various documentation available to assist users and developers. LinuxGSM primarily uses [GitBook](http://gitbook.com/) which uses the [Markdown](https://www.markdownguide.org/) document standard. LinuxGSM uses [Codacy](https://app.codacy.com/manual/GameServerManagers/LinuxGSM/dashboard) to analyse any Pull Requests to give you feedback on markup standards.
192
+
LinuxGSM has various documentation available to assist [users](https://docs.linuxgsm.com) and [developers](dev-docs.linuxgsm.com). LinuxGSM primarily uses [GitBook](http://gitbook.com/) which uses the [Markdown](https://www.markdownguide.org/) document standard. LinuxGSM uses [Codacy](https://app.codacy.com/manual/GameServerManagers/LinuxGSM/dashboard) to analyse any Pull Requests to give you feedback on markup standards.
0 commit comments