Skip to content

Commit 7e3df5d

Browse files
authored
Merge pull request #2968 from GameServerManagers/release/v20.4.0
Release v20.4.0
2 parents c94b8fa + 8121080 commit 7e3df5d

File tree

187 files changed

+1289
-669
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

187 files changed

+1289
-669
lines changed

CONTRIBUTING.md

Lines changed: 52 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -5,32 +5,34 @@
55
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.
66

77
## 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)
10+
* [Table of Contents](#table-of-contents)
1011
* [Code of Conduct](#code-of-conduct)
11-
* [Bug/Enhancement Contributions](#---bug-enhancement-contributions---)
12-
* [Reporting Bugs](#--reporting-bugs)
13-
* [Before Submitting A Bug Report](#before-submitting-a-bug-report)
14-
* [How Do I Submit A (Good) Bug Report?](#how-do-i-submit-a--good--bug-report-)
15-
* [Suggesting Features](#--suggesting-features)
16-
* [Before Submitting An Feature Suggestion](#before-submitting-an-feature-suggestion)
17-
* [How Do I Submit A (Good) Feature Suggestion?](#how-do-i-submit-a--good--feature-suggestion-)
18-
* [Game Server Requests](#---game-server-requests)
19-
* [Before Submitting a Game Server Request](#before-submitting-a-game-server-request)
20-
* [How Do I Submit A (Good) Game Server Suggestion?](#how-do-i-submit-a--good--feature-suggestion--1)
21-
* [Game Server Specific Issues](#---game-server-specific-issues)
22-
* [Code Contributions](#---code-contributions)
23-
* [Pull Requests](#pull-requests)
24-
* [Pull Request naming convention](#pull-request-naming-convention)
25-
* [Testing](#testing)
26-
* [Pull Request Status Checks](#pull-request-status-checks)
27-
* [Test Environment](#test-environment)
28-
* [Styleguides](#-wine-glass--styleguides)
29-
* [Git Commit Messages](#git-commit-messages)
30-
* [BASH Styleguide](#bash-styleguide)
31-
* [Document Contributions](#-blue-book--document-contributions)
32-
* [Documentation Styleguide](#documentation-styleguide)
12+
* [🎉 Bug/Enhancement Contributions 🐛](#bug-enhancement-contributions)
13+
+ [🐛Reporting Bugs](#reporting-bugs)
14+
- [Before Submitting A Bug Report](#before-submitting-a-bug-report)
15+
- [How Do I Submit A (Good) Bug Report?](#how-do-i-submit-a--good--bug-report-)
16+
+ [🎉Suggesting Features](#suggesting-features)
17+
- [Before Submitting An Feature Suggestion](#before-submitting-an-feature-suggestion)
18+
- [How Do I Submit A (Good) Feature Suggestion?](#how-do-i-submit-a--good--feature-suggestion-)
19+
+ [🎮 Game Server Requests](#game-server-requests)
20+
- [Before Submitting a Game Server Request](#before-submitting-a-game-server-request)
21+
- [How Do I Submit A (Good) Game Server Request?](#how-do-i-submit-a--good--game-server-request-)
22+
+ [🎮 Game Server Specific Issues](#game-server-specific-issues)
23+
* [💻 Code Contributions](#code-contributions)
24+
+ [Pull Requests](#pull-requests)
25+
- [Pull Request naming convention](#pull-request-naming-convention)
26+
+ [Testing](#testing)
27+
- [Pull Request Status Checks](#pull-request-status-checks)
28+
- [Test Environment](#test-environment)
29+
+ [:wine_glass: Styleguides](#-wine-glass--styleguides)
30+
- [Git Commit Messages](#git-commit-messages)
31+
- [BASH Styleguide](#bash-styleguide)
32+
* [:blue_book: Document Contributions](#-blue-book--document-contributions)
33+
+ [Documentation Styleguide](#documentation-styleguide)
3334
* [Issue and Pull Request Labels](#issue-and-pull-request-labels)
35+
3436
## Code of Conduct
3537

3638
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
4143

4244
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 🔎.
4345

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.
4547

4648
#### Before Submitting A Bug Report
4749

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.
4951
* **Check that the problem is not related to** [**support page**](https://linuxgsm/com/support) for links to other support options.
5052
* **Check the** [**support page**](https://linuxgsm/com/support) for links to other support options.
5153
* **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
8385

8486
### 🎮 Game Server Requests
8587

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 📝.
8889
#### Before Submitting a Game Server Request
8990

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.
9197

9298
### 🎮 Game Server Specific Issues
9399

94100
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.
95101

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.
97103

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.
99105

100106
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).
101107

@@ -112,7 +118,7 @@ The process described here has several goals:
112118

113119
Please follow these steps to have your contribution considered by the maintainers:
114120

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)
116122
2. Follow the [style guides](#styleguides)
117123
3. After you submit your pull request, verify that all [status checks](https://help.github.com/articles/about-status-checks/) are passing
118124

@@ -130,32 +136,32 @@ If applied, this commit will _your subject line here_
130136

131137
For example:
132138

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**
138144

139145
Notice how this doesn’t work for the other non-imperative forms:
140146

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**
145151

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:
147153

148-
feat(alerts): add slack support to alerts
154+
**feat(alerts): add slack support to alerts**
149155

150-
fix(csgoserver): remove SteamCMD auth requirement 32-bit workaround
156+
**fix(csgoserver): remove SteamCMD auth requirement 32-bit workaround**
151157

152158
### Testing
153159

154160
#### Pull Request Status Checks
155161
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.
156162

157163
#### 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.
159165
```bash
160166
## GitHub Branch Select
161167
# 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
183189

184190
### Documentation Styleguide
185191

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.
187193

188194
## Issue and Pull Request Labels
189195

0 commit comments

Comments
 (0)