Merge branch 'master' of github.com:shower/shower
This commit is contained in:
commit
56b02ec5c3
|
@ -1,32 +1,33 @@
|
||||||
# Contributing to Shower
|
# Contributing to Shower
|
||||||
|
|
||||||
You're always welcome to contibute! There are three repositories in Shower project:
|
You're always welcome to contibute! There are five repositories in Shower project:
|
||||||
|
|
||||||
- [Shower](https://github.com/shower/shower) engine with Ribbon theme
|
- [Shower](https://github.com/shower/shower) engine with Ribbon theme
|
||||||
- [Template](https://github.com/shower) for Shower engine and built-in themes
|
- [Template](https://github.com/shower/template) for Shower engine and built-in themes
|
||||||
- [Ribbon](https://github.com/shower/ribbon) theme for Shower
|
- [Ribbon](https://github.com/shower/ribbon) theme for Shower
|
||||||
- [Bright](https://github.com/shower/bright) theme for Shower
|
- [Bright](https://github.com/shower/bright) theme for Shower
|
||||||
|
- [Jekyller](https://github.com/shower/jekyller) generator for Shower
|
||||||
|
|
||||||
The most important part of the project is the [Shower](https://github.com/shower/shower) repository, containing [shower.js](https://github.com/shower/shower/blob/master/shower.js) file.
|
The most important part of the project is the [Shower](https://github.com/shower/shower) repository, containing [shower.js](https://github.com/shower/shower/blob/master/shower.js) file.
|
||||||
|
|
||||||
## Issues
|
## Issues
|
||||||
|
|
||||||
Before starting to contribute to Shower please read through [Issues](https://github.com/shower/shower/issues?state=open) to see opened bugs and feature requests. If you have any feature to add to Shower, please make sure that you file an issue with your ideas first. If you've found a bug and want to fix it, please file an issue first. It might be a feature!
|
Before contributing to Shower, please read through [Issues](https://github.com/shower/shower/issues?state=open) to see open bugs and feature requests. If you have any feature to add to Shower, please make sure that you file an issue with your ideas first. If you've found a bug and want to fix it, please file an issue first. It might be a feature!
|
||||||
|
|
||||||
|
|
||||||
## Process
|
## Process
|
||||||
|
|
||||||
To contribute to Shower fork needed repository and start making changes. Don't forget to add upstream link to original repository and keep your fork updated. When you finished send pull request back to original repository and supply clear description or link to existing issue.
|
To contribute to Shower, fork needed repository and start making changes. Don't forget to add upstream link to original repository and keep your fork updated. When you finish, send pull request back to original repository and supply clear description or link to existing issue.
|
||||||
|
|
||||||
## Code style
|
## Code style
|
||||||
|
|
||||||
Please keep existing code style while contributing to Shower and be ready for code review by Shower authors and contributors. It's strognly recommended to validate your JavaScript changes using [JSHint](http://jshint.com/).
|
Please keep existing code style while contributing to Shower and be ready for code review by Shower authors and contributors. It's strongly recommended to validate your JavaScript changes using [JSHint](http://jshint.com/).
|
||||||
|
|
||||||
By historical reasons, Shower project is using tabs instead of spaces for code indentation. It's not a big deal to keep this rule while contributing using you code editor options, even if your code style is 13.4 spaces.
|
By historical reasons, Shower project is using tabs instead of spaces for code indentation. It's not a big deal to keep this rule while contributing using you code editor options, even if your code style is 13.4 spaces.
|
||||||
|
|
||||||
## Language
|
## Language
|
||||||
|
|
||||||
English is the main language for Shower project. All discussions and commit messages should be in English no matter if it's good or bad. The second language of Shower is Russian. Offical Shower themes are always compatible with Cyrillic and Russian typography. All documentation to Shower is always localized to Russian.
|
English is the main language for Shower project. All discussions and commit messages should be in English, no matter if it's good or bad. The second language of Shower is Russian. Offical Shower themes are always compatible with Cyrillic and Russian typography. All documentation to Shower is always localized to Russian.
|
||||||
|
|
||||||
---
|
---
|
||||||
If you have any question please ask [@shower_me](http://twitter.com/shower_me/) or file an [issue](https://github.com/shower/shower/issues?state=open).
|
If you have any questions, please ask [@shower_me](http://twitter.com/shower_me/) or file an [issue](https://github.com/shower/shower/issues?state=open).
|
||||||
|
|
Loading…
Reference in New Issue