Create CONTRIBUTING.md
This commit is contained in:
parent
3778d14d67
commit
b932d1c79f
1 changed files with 47 additions and 0 deletions
47
CONTRIBUTING.md
Normal file
47
CONTRIBUTING.md
Normal file
|
@ -0,0 +1,47 @@
|
||||||
|
# IDG Contributing Guidelines
|
||||||
|
|
||||||
|
These examples will show the IDG Guidelines for contributing. Please follow this at all times, or your contribution may be reverted.
|
||||||
|
|
||||||
|
## Basic Guidelines:
|
||||||
|
- Use Tabs to indent code, DO NOT USE SPACE.
|
||||||
|
- Use lowerCamelCase or underscores for naming Nasal variables/functions (someFunction, some_function).
|
||||||
|
- Comments optional for XML, mandatory for Nasal.
|
||||||
|
- Do not add a comment to every line, only to functions/groups of code.
|
||||||
|
- Remove .ac or .bak files, unless absolutely needed.
|
||||||
|
- Leave one extra line at the bottom of each file.
|
||||||
|
|
||||||
|
## Formatting Guidelines:
|
||||||
|
Indenting and Line Breaks:
|
||||||
|
```
|
||||||
|
<!-- XML -->
|
||||||
|
<something>
|
||||||
|
<something-else>0</something-else>
|
||||||
|
<something-more>
|
||||||
|
<more-stuff></more-stuff>
|
||||||
|
</something-more>
|
||||||
|
</something>
|
||||||
|
```
|
||||||
|
|
||||||
|
```
|
||||||
|
# Nasal
|
||||||
|
var something = func {
|
||||||
|
somethingElse();
|
||||||
|
}
|
||||||
|
```
|
||||||
|
Brackets, Spaces, Commas, Semi-Colons, and Parentheses:
|
||||||
|
```
|
||||||
|
var something = 0;
|
||||||
|
var someOtherThing = func {
|
||||||
|
if (something == 1) {
|
||||||
|
something = 0;
|
||||||
|
} else {
|
||||||
|
something = 1;
|
||||||
|
}
|
||||||
|
settimer(func {
|
||||||
|
setprop("/something", something);
|
||||||
|
}, 5);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Forks, Branches, and Merging
|
||||||
|
We do not add contributors outside of IDG, so please fork the repository, and commit your changes there. Branches are optional. When you are ready for IDG to look over you work, submit a pull request, following our pull request template, and an IDG Developer will look over it. If there is an issue that needs to be resolved before merging, the IDG Developer will leave a comment on the pull request.
|
Reference in a new issue