Fix some typos in CONTRIBUTING.md (#422)

This commit is contained in:
RDR8 2017-12-19 02:19:43 -06:00 committed by Ahmad Fatoum
parent 647d8b2d53
commit 8d5484bbe0
1 changed files with 23 additions and 23 deletions

View File

@ -8,7 +8,7 @@ Use your best judgement, and feel free to propose changes to this document in a
### raylib philosophy
- raylib is a tool to LEARN videogames programming, every single function in raylib should be a tutorial on itself.
- raylib is SIMPLE and EASY-TO-USE, I tried to keep it compact with a small set of functions, if a function is too complex or has not a clear usefulness, better not to include it.
- raylib is SIMPLE and EASY-TO-USE, I tried to keep it compact with a small set of functions, if a function is too complex or is not clearly useful, better not to include it.
- raylib is open source and free; educators and institutions can use this tool to TEACH videogames programming completely by free.
- raylib is collaborative; contribution of tutorials / code-examples / bugs-solving / code-comments are highly appreciated.
- raylib's license (and its external libs respective licenses) allow using it for commercial products.
@ -23,6 +23,18 @@ Use your best judgement, and feel free to propose changes to this document in a
[raylib Wiki](https://github.com/raysan5/raylib/wiki) contains some information about the library and is open to anyone for edit.
Feel free to review it if required, just take care not to break anything.
### raylib C coding conventions
Despite being written in C, raylib does not follow the standard Hungarian notation for C,
it [follows Pascal-case/camel-case notation](https://github.com/raysan5/raylib/wiki/raylib-coding-conventions),
more common on C# language. All code formatting decisions have been carefully taken
to make it easier for students to read, write and understand code.
Source code is extensively commented for that purpose, raylib primary learning method is:
> learn by reading code and examples
### Using raylib develop branch
raylib [master branch](https://github.com/raysan5/raylib) contains latest raylib release but all
@ -36,21 +48,9 @@ use provided [Makefile](https://github.com/raysan5/raylib/blob/develop/src/Makef
For detailed information on building raylib and examples, please check [raylib Wiki](https://github.com/raysan5/raylib/wiki).
### raylib C coding conventions
Despite being written in C, raylib does not follow the standard hungarian notation for C,
it [follows Pascal-case/camel-case notation](https://github.com/raysan5/raylib/wiki/raylib-coding-conventions),
more common on C# language. All code formatting decisions have been carefully taken
to make it easier for students to read, write and understand code.
Source code is extensively commented for that pourpose, raylib primary learning method is:
> learn by reading code and examples
### Opening new Issues
To open new issue for raylib (bug, enhacement, discussion...), just try to follow this rules:
To open new issue for raylib (bug, enhacement, discussion...), just try to follow these rules:
- Make sure the issue has not already been reported before by searching on GitHub under Issues.
- If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a
@ -62,16 +62,16 @@ To open new issue for raylib (bug, enhacement, discussion...), just try to follo
### Sending a Pull-Request
To send a pull-request, first of all, make sure you're sending it to **develop-branch**. Here are some other rules:
To send a pull-request, first of all, make sure you're sending it to [develop branch](https://github.com/raysan5/raylib/tree/develop). Here are some other rules:
- Make sure thee PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
- Make sure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
- Don't send big pull-requests (lots of changelists), they are difficult to review. It's better to send small pull-request, one at a time.
- Verify that changes don't break the build (at least on Windows platform). As many platforms where you can test it, the better, but don't worry
if you can not test all the platforms.
if you cannot test all the platforms.
### raylib bindings
Some people ported raylib to other languages in form of bindings or wrappers to the library, here it is a list with the ones I'm aware:
Some people ported raylib to other languages in form of bindings or wrappers to the library, here is a list with the ones I'm aware of:
- [raylib C/C++ version (default)](https://github.com/raysan5/raylib)
- [raylib Lua binding](https://github.com/raysan5/raylib-lua)
@ -83,12 +83,12 @@ Some people ported raylib to other languages in form of bindings or wrappers to
Usually, raylib bindings follow the convention: `raylib-{language}`
Let me know if you're writting a new binding for raylib, I will list it here and I usually
Let me know if you're writing a new binding for raylib, I will list it here and I usually
provide the icon/logo for that new language binding.
### contact information
### Contact information
If you have any doubt, don't hessitate to [contact me](mailto:ray@raylib.com)!.
If you have any doubt, don't hesitate to [contact me](mailto:ray@raylib.com)!.
You can write me a direct mail but you can also contact me on the following networks:
- [raylib forum](http://forum.raylib.com/) - A good place for discussions or to ask for help.
@ -100,8 +100,8 @@ Thank you very much for your time! :)
----
Here it is a list of raylib contributors, this people has invested part of their time
contributing (in some way or another) to make raylib project better. Huge thanks to all of them!
Here is a list of raylib contributors, these people have invested part of their time
contributing (in some way or another) to make the raylib project better. Huge thanks to all of them!
- [Zopokx](https://github.com/Zopokx) for testing the web.
- [Elendow](http://www.elendow.com) for testing and helping on web development.