Developer Central: Difference between revisions

From xoreos Wiki
Jump to navigation Jump to search
(Add a link to our Code of Conduct)
Line 4: Line 4:
== Getting started ==
== Getting started ==
* The first thing you need to be able to do is [[Git#Retrieving_the_code|get the xoreos code]] from our [[Git]] repository.
* The first thing you need to be able to do is [[Git#Retrieving_the_code|get the xoreos code]] from our [[Git]] repository.
* Then you should [[Compiling xoreos|compile xoreos]].
* Then you should [[Compiling xoreos|compile xoreos]] and/or [[Compiling xoreos-tools|compile xoreos-tools]].


That was easy, right? Here are some more tips:
That was easy, right? Here are some more tips:
Line 13: Line 13:
* If you do not have write (push) access to our repository, you should submit your contributions by the following method:
* If you do not have write (push) access to our repository, you should submit your contributions by the following method:
** Using a [https://help.github.com/articles/using-pull-requests Github Pull Request].<br> This requires you to have/register a github account, fork our repository, commit your changes to a branch and then issue a Pull Request.<br>This is the current preferred method as it is easier for the team to review, discuss and amend prior to merging.<br>You are expected to have read and to comply with our [[Commit Guidelines]].
** Using a [https://help.github.com/articles/using-pull-requests Github Pull Request].<br> This requires you to have/register a github account, fork our repository, commit your changes to a branch and then issue a Pull Request.<br>This is the current preferred method as it is easier for the team to review, discuss and amend prior to merging.<br>You are expected to have read and to comply with our [[Commit Guidelines]].


== Reverse engineering help ==
== Reverse engineering help ==

Revision as of 11:02, 16 September 2015

The purpose of this page is to give a link to all kinds of resources that contain information valuable to current and future developers of xoreos.


Getting started

That was easy, right? Here are some more tips:

  • Please read our Code of Conduct. By participating in this project you agree to abide by its terms.
  • Before you write/submit code, you must read our Code Formatting Conventions.
    Patches which do not follow them will be rejected or at least delayed until they are cleaned up to comply to them.
  • If you have write (push) access to our repository, you are expected to have read and to comply with our Commit Guidelines.
    Also, please read the tips for using Git here: Git tips.
    In particular, note the use of feature branches, when working on refactoring or other large connected changes, rather than committing directly to xoreos/master.
  • If you do not have write (push) access to our repository, you should submit your contributions by the following method:
    • Using a Github Pull Request.
      This requires you to have/register a github account, fork our repository, commit your changes to a branch and then issue a Pull Request.
      This is the current preferred method as it is easier for the team to review, discuss and amend prior to merging.
      You are expected to have read and to comply with our Commit Guidelines.

Reverse engineering help

For people starting out with reverse engineering, here are a few useful resources:


To do list

Our Main TODO list contains a rambly, non-exhaustive collection of things left to do.