Contribution Guide

We are looking forward to every conbtirbution you possibly can bring in. If you want to contribute please read this document carefully.

If you encounter serious errors while using NetEvent and you are not able to fix them, feel free to open issues on https://github.com/Lan2Play/NetEvent/issues .

If you plan to add a feature to NetEvent, please open an issue as well and draft a pull request as soon as you have done something, so no one has to do work that someone already did.

Documentation

This documentation is written in restructured text and its build using sphinx and the read the docs theme. The source can be found in our main repository in the Docs/ subfolder (https://github.com/Lan2Play/NetEvent/tree/main/Docs). Feel free to pull request corrections or expansions of the documentation at any time!

To build the documentation locally to the Docs/build subfolder you have two options:

Building with docker and the make file (recommended)
Building manually with the sphinx make file

Building with docker and the make file

Windows

Prerequisites:

Docker for Windows with wsl2 backend (https://docs.docker.com/docker-for-windows/wsl/ Follow the prerequisites, the download and the install part!)

Warning

If you are using git, consider cloning the repository within your wsl distro instead of with git for windows to get around line ending problems!

To build the documentation just enter yor wsl2 distribution and follow the linux part below!

Linux

Prerequisites:

Docker (https://docs.docker.com/engine/install)
Make (should be available for nearly every linux distro in the corresponding packagemanager)

In order to build the documentation you have to change to the root folder of the repository and run

make docs-html

Building manually with the sphinx make file

Windows

Prerequisites:

python 3 (https://docs.python.org/3/using/index.html) with pip
sphinx (https://www.sphinx-doc.org/en/master/usage/installation.html)
the read the docs theme (https://github.com/readthedocs/sphinx_rtd_theme#installation)

open a cmd or powershell and change your folder to the Docs/ subfolder and run

CMD

make.bat html

Psh

./make.bat html

Linux

Prerequisites:

python 3 (https://docs.python.org/3/using/index.html) with pip
sphinx (https://www.sphinx-doc.org/en/master/usage/installation.html)
the read the docs theme (https://github.com/readthedocs/sphinx_rtd_theme#installation)
Make (should be available for nearly every linux distro in the corresponding packagemanager)

open your favorite shell and change your folder to the Docs/ subfolder and run

make html

Translation / i18n

If you want to help with the translation of NetEvent, please check out our Translation / i18n section

Code

If you want to get into coding for NetEvent, check out the Developers start guide, there you can find an introduction into how to setup your development environment, how the contribution process looks like and some specific parts of NetEvent where we would love to see adaption for more usecases.