From b932d1c79f8bec0651173fda017c5b178b882da5 Mon Sep 17 00:00:00 2001 From: Joshua Davidson Date: Mon, 16 Oct 2017 18:08:28 -0400 Subject: [PATCH] Create CONTRIBUTING.md --- CONTRIBUTING.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 00000000..223a5b01 --- /dev/null +++ b/CONTRIBUTING.md @@ -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: +``` + + + 0 + + + + +``` + +``` +# 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.