Browse Source

Added contributing guides

Tobias Reich 10 years ago
parent
commit
7387ca868f
1 changed files with 37 additions and 0 deletions
  1. 37 0
      CONTRIBUTING.md

+ 37 - 0
CONTRIBUTING.md

@@ -0,0 +1,37 @@
+## How to report a bug
+
+Read the following before reporting a bug on GitHub:
+
+1. Update to the newest version of Lychee
+2. Update your Browser to the newest version
+2. Take a look in the [FAQ](https://github.com/electerious/Lychee/blob/master/docs/FAQ.md)
+3. Check if someone has [already reported](https://github.com/electerious/Lychee/issues) the same bug
+
+When reporting a bug on GitHub, make sure you include the following information:
+
+- Detailed description of the problem
+- How to reproduce the issue (step-by-step)
+- What you have already tried
+- Output of the diagnostics (`plugins/check/index.php`)
+- Browser and Browser version
+- Attach files when you have problems which specific photos
+
+## Coding Guidelines
+
+Check if there are branches newer than `master`. Always fork the newest available branch.
+
+Please follow the conventions already established in the code.
+
+- **Spacing**:<br>
+  Use tabs for indentation. No spaces.
+
+- **Naming**:<br>
+  Keep variable and method names concise and descriptive.
+
+- **Quotes**:<br>
+  Single-quoted strings are preferred to double-quoted strings
+  
+- **Comments**:<br>
+  Please use single-line comments to annotate significant additions. Use `#` for comments in PHP; `//` for comments in JS and CSS.
+  
+Merge you changes when the forked branch has been updated in the meanwhile. Make sure your code is 100% working before creating a Pull-Request on GitHub.