Coding guidelines - Revision history

Fernando187: Update link to mtasa-docs

2024-07-20T14:29:13Z

Update link to mtasa-docs

← Older revision		Revision as of 14:29, 20 July 2024
Line 2:		Line 2:
	The Multi Theft Auto: San Andreas source code is available on GitHub in the [https://github.com/multitheftauto/mtasa-blue mtasa-blue repository].		The Multi Theft Auto: San Andreas source code is available on GitHub in the [https://github.com/multitheftauto/mtasa-blue mtasa-blue repository].

	The [https://github.com/multitheftauto/mtasa-~~blue~~/blob/~~master~~/CONTRIBUTING.md CONTRIBUTING.md document] is a general guide to contributing to the project, where you will find the Coding guidelines.		The [https://github.com/multitheftauto/mtasa-docs/blob/main/mtasa-blue/CONTRIBUTING.md CONTRIBUTING.md document] is a general guide to contributing to the project, where you will find the Coding guidelines.

	[[Category: Development]]		[[Category: Development]]

Fernando187: Remove old new coding guidelines link

2024-07-20T14:27:31Z

Remove old new coding guidelines link

← Older revision		Revision as of 14:27, 20 July 2024
Line 2:		Line 2:
	The Multi Theft Auto: San Andreas source code is available on GitHub in the [https://github.com/multitheftauto/mtasa-blue mtasa-blue repository].		The Multi Theft Auto: San Andreas source code is available on GitHub in the [https://github.com/multitheftauto/mtasa-blue mtasa-blue repository].

	The [https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md CONTRIBUTING.md document] is a general guide to contributing to the project.		The [https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md CONTRIBUTING.md document] is a general guide to contributing to the project, where you will find the Coding guidelines.

	~~Here~~, you ~~can~~ find the ~~most up-to-date coding~~ guidelines ~~that contributors should follow: [[New coding guidelines]]~~

	[[Category: Development]]		[[Category: Development]]

Fernando187 at 12:11, 8 July 2024

2024-07-08T12:11:25Z

← Older revision		Revision as of 12:11, 8 July 2024
Line 2:		Line 2:
	The Multi Theft Auto: San Andreas source code is available on GitHub in the [https://github.com/multitheftauto/mtasa-blue mtasa-blue repository].		The Multi Theft Auto: San Andreas source code is available on GitHub in the [https://github.com/multitheftauto/mtasa-blue mtasa-blue repository].

	The [https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md CONTRIBUTING.md document] ~~serves as~~ a general guide to contributing to the project.		The [https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md CONTRIBUTING.md document] is a general guide to contributing to the project.

	Here, you can find the most up-to-date coding guidelines that contributors should follow: [[New coding guidelines]]		Here, you can find the most up-to-date coding guidelines that contributors should follow: [[New coding guidelines]]

	[[Category: Development]]		[[Category: Development]]

Fernando187: Add link to repository, CONTRIBUTING.md and New coding guidelines

2024-07-08T12:10:57Z

Add link to repository, CONTRIBUTING.md and New coding guidelines

← Older revision		Revision as of 12:10, 8 July 2024
Line 1:		Line 1:
	= [https://github.com/multitheftauto/mtasa-blue~~/blob/master/CONTRIBUTING.md#contributors~~-~~guide These guidelines are now on GitHub~~] =		== MTA:SA Project ==
			The Multi Theft Auto: San Andreas source code is available on GitHub in the [https://github.com/multitheftauto/mtasa-blue mtasa-blue repository].

			The [https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md CONTRIBUTING.md document] serves as a general guide to contributing to the project.

			Here, you can find the most up-to-date coding guidelines that contributors should follow: [[New coding guidelines]]

	[[Category: Development]]		[[Category: Development]]

Fernando187: re-add Category: Development

2024-06-29T11:10:06Z

re-add Category: Development

← Older revision		Revision as of 11:10, 29 June 2024
Line 1:		Line 1:
	= [https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md#contributors-guide These guidelines are now on GitHub] =		= [https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md#contributors-guide These guidelines are now on GitHub] =


			[[Category: Development]]

Myonlake: Reverted edits by Hyper (talk) to last revision by Qaisjp

2023-06-15T07:02:05Z

Reverted edits by Hyper (talk) to last revision by Qaisjp

← Older revision		Revision as of 07:02, 15 June 2023
Line 1:		Line 1:
	~~Deadly Team On Top~~		= [https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md#contributors-guide These guidelines are now on GitHub] =
	https://~~discord~~.gg/~~DG5kzCZk~~

Hyper at 00:45, 15 June 2023

2023-06-15T00:45:00Z

← Older revision		Revision as of 00:45, 15 June 2023
Line 1:		Line 1:
	~~= [~~https://~~github~~.~~com~~/~~multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md#contributors-guide These guidelines are now on GitHub] =~~		Deadly Team On Top
			https://discord.gg/DG5kzCZk

Qaisjp: anchor link

2020-12-22T16:43:15Z

anchor link

← Older revision		Revision as of 16:43, 22 December 2020
Line 1:		Line 1:
	= [https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md These guidelines are now on GitHub] =		= [https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md#contributors-guide These guidelines are now on GitHub] =

Qaisjp: CONTRIBUTING.md has been merged and replaces this page

2020-12-22T16:42:29Z

CONTRIBUTING.md has been merged and replaces this page

← Older revision		Revision as of 16:42, 22 December 2020
Line 1:		Line 1:
	= ~~Introduction =~~		= [https://github.com/multitheftauto/mtasa-blue/blob/master/CONTRIBUTING.md These guidelines are now on GitHub] =

	So you've decided to become a contributor to our project. Excellent! But before we can start accepting your code, there are a couple of things you should know about how we work. These are mostly guidelines and rules as to how your code should be structured and how it can be committed without upsetting any fellow contributors.

	~~= Code repository =~~

	~~== Structure ==~~

	~~Our branches contain groundbreaking research, radical ideas and other work-in-progress that is meant to be merged into the trunk at a later point, but also contains project milestones:~~

	* The master branch is the main development branch (containing the latest, bleeding-edge code)
	* Project milestones are kept away from the trunk for stability reasons, but the latest version branch can be used by any regular player who has enabled nightly builds. Make sure that only well tested code is added to the latest version branch.

	~~== Gaining and Losing Commit access ==~~
	Commit access is granted after patches have been submitted, and the coder has proven to be competent. The subject matter of the patches does not matter, we are more interested in whether if you are granted commit access, you will be capable of maintaining a high standard of code and remaining cohesive with other project contributors.

	~~Patches can be submitted using~~ [https://github.com/multitheftauto/mtasa-blue/~~pull~~/new GitHub's pull request system]. Usually commit access is gained after 2-3 patches, but this is not fixed and depends on the extent of the contributions. This requires you to fork our repository and make commits to your own branch first.

	After gaining commit access, if the contributor's commits are of a consistently low standard, or the user fails to stick to the rules, their commit access will be stripped and will be required to submit pull requests again.

	~~== Committing code ==~~
	~~Keep in mind that your commits should initially be fixing or implementing existing issues on our [http:~~/~~/bugs~~.~~mtasa.com bug tracker]. The [http://bugs.mtasa.com/roadmap_page.php roadmap] is particularly important since it allows contributors to track down priority issues.~~

	~~Please follow these~~ guidelines ~~for all your contributions:~~
	* Commits should be thoroughly tested when added to master. Commits that 'need to be fixed later' which directly affect the state of the mod will be reverted other than in exceptional circumstances.
	* If writing unstable or experimental code, a private branch should be added in your own fork. Branches should not be "personal" to each user. This means that a branch should be created for a new feature, not for a user specific playground.
	* Commit messages should always give a clear indication of the content of the change, without having to look at the code at all. Where appropriate, include the Mantis Issue number in your log message and keep your log messages consistent, e.g. '''Fix #1234: description and notes here'''. [http://chris.beams.io/posts/git-commit/ Follow the seven rules identified here.]
	* When committing updates to previous commits, include the previous commit SHA (and a summarised commit message) in the new commit message. Doing this will help identify related commits if they are ~~viewed at a later date.~~
	* Follow the [https://github.com/multitheftauto/mtasa-blue/wiki/Style-Guide Style Guide].

	~~== Ratings and comments ==~~
	Ratings and comments are open for the public to review code and provide feedback. Please be mature and civilised when posting comments. Developers should try to review other contributor's commits and provide feedback as much as possible.

	~~Make sure you make appropriate use of the~~ GitHub ~~Reactions feature to rate commits or express agreement/disagreement to a comment. This avoids spammy comments such as "+1", "-1", "Nice one!", etc.~~

	~~Since you can only react to comments, not commits, feel free to create the initial "+1" comment in response to a commit. However, future reactions to a commit should be to the first response comment.~~

	~~== What to code ==~~
	~~Generally, developers should try to stick to the [http://bugs.mtasa.com/roadmap_page.php roadmap~~] ~~when coding. This lists the issues required to be resolved for the next release. Of course, if you're interested in something else, feel free to experiment and submit it.~~

	== ~~Coding info ==~~
	~~Check out the [[Coding info]] page and feel free to add more coding info to it.~~

	~~[[Category: Development]]~~

	~~[[hu:HU/Coding guidelines]]~~

Qaisjp: /* Structure */ move directory structure to coding info

2020-02-29T20:56:45Z

Structure: move directory structure to coding info

← Older revision		Revision as of 20:56, 29 February 2020
Line 6:		Line 6:

	== Structure ==		== Structure ==
	~~Our code repository uses Git and is structured into number of different directories, which serve different purposes:~~

	* '''Client'''
	* '''Server'''
	* '''Shared''': contains code shared between both the client and the server
	* '''irc''': bot code for the Multi Theft Auto IRC channels
	* '''m4'''
	* '''utils''': utilities used to automate certain tasks
	* '''vendor''': unmodified third-party code and libraries (optionally linked to the appropriate third-party Git repository through Git submodules).

	Our branches contain groundbreaking research, radical ideas and other work-in-progress that is meant to be merged into the trunk at a later point, but also contains project milestones:		Our branches contain groundbreaking research, radical ideas and other work-in-progress that is meant to be merged into the trunk at a later point, but also contains project milestones: