codiad/CONTRIBUTING.md

56 lines
2.5 KiB
Markdown
Raw Normal View History

# How to Contribute
2020-01-06 04:13:45 +01:00
Your contributions are welcome and we're very open about how contributions are made; however, to keep order to things please take the following into consideration:
* Check the issues to ensure that someone else isn't already working on the bug or feature
* Submit an issue for bugs and feature additions before you start with it
* Familiarize yourself with the documentation in the [Wiki](https://gitlab.com/xevidos/codiad/wikis/home)
2020-01-07 06:00:20 +01:00
**Merge Requests** All merge requests should be submitted for merging into the development branch. All tests and checks are run on that branch before merging into master to form a release.
There is an established format for `components` which utilizes one JS (`init.js`) and one CSS (`screen.css`) which is handled by the loader file. Any other resources used should be loaded or accessed from one of these. Plugins and Themes made for Codiad do not need to follow our formatting styles below, but any contributions to the core should.
2020-01-06 04:13:45 +01:00
**Don't Reinvent the Wheel!** There's an API and a defined, easy-to-understand set of methods for a reason - use them.
2020-01-07 06:00:20 +01:00
Stick to the conventions defined in other components as closely as possible.
* Utilize the same commenting structure
2020-01-06 04:13:45 +01:00
* Use underscores in namespaces instead of camelCase
* Indent using tabs
* When working with the editor utilize the `active` object whenever possible instead of going direct to the `editor`
**Javascript Formatting**
2020-01-06 04:13:45 +01:00
In order to maintain a consistent code structure to the code across the application, please follow the WordPress standard, or run any changes through [JSBeautifier] (http://jsbeautifier.org/) with the settings below.
{
2019-06-27 14:43:19 +02:00
"brace_style": "collapse",
"break_chained_methods": false,
"comma_first": false,
"e4x": false,
"end_with_newline": true,
"indent_char": "\t",
2019-06-27 14:43:19 +02:00
"indent_empty_lines": true,
"indent_inner_html": true,
"indent_scripts": "normal",
"indent_size": "1",
"jslint_happy": false,
"keep_array_indentation": true,
"max_preserve_newlines": "5",
"preserve_newlines": true,
2019-06-27 14:43:19 +02:00
"space_after_anon_function": false,
"space_after_named_function": false,
"space_before_conditional": false,
2019-06-27 14:43:19 +02:00
"space_in_empty_paren": false,
"space_in_paren": true,
"unescape_strings": false,
2019-06-27 14:43:19 +02:00
"unindent_chained_methods": true,
"wrap_line_length": "0"
}
If you have questions, please ask. Submit an issue or [contact us directly](mailto:support@telaaedifex.com).
**PHP Formatting**
2020-01-06 04:13:45 +01:00
In order to maintain a consistent code structure we follow WordPress standards.