mirror of
https://github.com/CachetHQ/Cachet.git
synced 2025-01-17 21:49:01 +01:00
1.9 KiB
1.9 KiB
Contribution Guidelines
## Creating issues
It's dead simple, use the issue tracker. Be descriptive, remember this is a community and we're all helping each other, so be respectful towards each other.
Coding Standards
Please follow existing coding standards:
<?php
namespace Foo\Bar\Controller;
use Foo\Bar\Bar;
class Foo extends Bar {
public function baz() {
if ($condition) {
}
}
}
- At least one newline seperating
namespace
,use
, andclass
declarations - Spaces around operators and control blocks:
if ($condition) { }
- Braces on the same line. The exception to this rule is for long conditions.
- Line lengths have a soft 80 limit and hard 120 length.
- PHP constants should be in lowercase;
true
,false
andnull
. - Defined constants should always be in uppercase.
- Never leave trailing spaces at the end of a line.
- Files should end with one blank line.
If you're still unsure, then take a look at existing code.
Intro to Git and GitHub
If you are new to git, GitHub, and the whole open source software community, welcome! Here are some resources for getting started and understanding what it's all about.
- Try Git by Code School
- GitHub Help
If you're not particularly fond of the command line, you can get one of GitHub's free GUI desktop apps:
If you're feeling advantageous, you can become a Git & GitHub master with the Git Path on Code School.
There is always the Cachet Gitter chat to ask any questions you may have: