HOWTO: Contribute to Red Eclipse

Items of particular interest to the entire community

HOWTO: Contribute to Red Eclipse

Postby qreeves » 04 Feb 2015 22:50

For the most up to date version of this guide, please see http://redeclipse.net/wiki/How_to_Contribute_to_Red_Eclipse.

This guide is a basic introduction to the development model for Red Eclipse, including the procedure for submitting modifications and creating new ideas. It is suggested you read this in its entirety before starting any development related work, as it contains vital information regarding proper etiquette.

Preliminaries

Red Eclipse development is done with GIT. From there, you are able to create Issues or Pull Requests (these link to the "base" module, there are separate modules for "data" and "site"). If you are unfamiliar with GIT it is recommended to read a few tutorials on the net in order to avoid asking embarrassing questions. GitHub brings the advantage of a familiar interface with a robust set of features aimed at improving collaborative development and built to handle most of what users need from it, including help documentation.

The tree is split up into the following:
If you are on Windows and don't like the official GitHub application you can try MSysGit or TortoiseGit. If you are on Linux you should be able to obtain the git command line tools from your distribution/package manager.

Here's a rundown of how to setup a new repository:
Code: Select all
git clone --recursive https://github.com/red-eclipse/base.git redeclipse

Content/Idea/Proposal Guidelines

  • Create a piece of content, come up with an idea, or decide to propose a change you want included in Red Eclipse.
  • Then, create a thread for it, either in Maps and Mods for content, or General Discussion for ideas/proposals.
  • Give the community a chance to provide feedback, or answer a poll (minimum time should be about 2 weeks).
  • When you feel you have come up with a finished work, idea, or proposal, submit it to the appropriate git module as an issue or pull request.
  • Provide a good description along with a link to your original forum topic.
  • Attach, or provide direct links to, any files you are attempting to have included here.
  • Feel free to share a link to your post while we review it.
Issue Reporting Guidelines

  • Find an issue in the Red Eclipse game and/or engine, verify that you can reproduce the problem and provide steps on how to do so.
  • Check on the forums or issue tracker to see if your issue has already been reported and/or resolved upstream (in the development version).
  • When you have verified that the issue still exists and needs to be fixed, submit it to the appropriate git module as an issue or pull request.
  • Provide a good description along with a link to your original forum topic (if applicable).
  • Attach, or provide direct links to, any files which demonstrates your issue and any patches you might have here.
General Guidelines

  • Only submit finalised works (no work-in-progress items please). If you are just looking for general feedback, you can use the forums (or a git fork!).
  • You acknowledge we will probably modify your content before including it (to fix any problems or improve it).
  • If you want to modify it at a later point, changes you make will need to be based on our version, otherwise we may not include your updates.
  • You must provide an explicit, legally enforceable license. Do not use "public domain", or "no commercial use" / "no modification allowed" clauses. If you don't, it will be assumed you are happy to use the Red Eclipse general license which best applies to the work.
If you are unsure about how to license your work, Creative Commons provides a handy selection tool for their licenses at http://creativecommons.org/choose/ and Red Eclipse content is generally licensed "CC by-sa" (Attribution-ShareAlike), unless otherwise specified: http://creativecommons.org/licenses/by-sa/3.0/

Helpful Things

The following BBcodes are available to reference GIT information here on the forum:
User avatar
qreeves
Site Admin
 
Posts: 1542
Joined: 02 Feb 2014 05:04
Location: Australia

Return to News and Articles