knowledge/programming-books
1
0
Fork 0
mirror of https://github.com/namibia/free-programming-books.git synced 2024-11-25 21:07:34 +00:00
Code Issues Releases Activity

Enhance CONTRIBUTING.md

Browse Source
This commit is contained in:
Victor Felder 2015-11-02 16:43:16 +01:00
parent 60f52ec85d
commit 6275f32d88
1 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
CONTRIBUTING.md
View File

@ -1,21 +1,21 @@
## Contributor license agreement ## Contributor license agreement
By contributing you agree to the [LICENSE](https://github.com/vhf/free-programming-books/blob/master/LICENSE) of this repository. By contributing you agree to the [LICENSE](https://github.com/vhf/free-programming-books/blob/master/LICENSE) of this repository.
## Free, Git, and Files ## In a nutshell
1. First of all, what you want to add should be free. Don't confuse "an easy link to download a book" with "a free book". 1. "An easy link to download a book" is not necessarily a *free* book. Please only contribute free content.
2. If you don't know how to work with git or github, simply refer to our wiki [Contribution](https://github.com/vhf/free-programming-books/wiki/Contribution). 2. You don't have to know git: if you found something of interest which is *not already in this repo*, please open an issue with your links propositions.
- If you know git, please fork the repo and send pull requests.
3. We have 5 kinds of lists. Choose the right one: 3. We have 5 kinds of lists. Choose the right one:
- **Books** : PDF, HTML, ePub, a gitbook.io based site, a Git repo, etc. - *Books* : PDF, HTML, ePub, a gitbook.io based site, a Git repo, etc.
- **Courses** : A course is a learning material which is not a book and where there is no interactive tool embeded in the site. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). - *Courses* : A course is a learning material which is not a book and where there is no interactive tool embeded in the site. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
- **Interactive Tutorials** : An interactive website which lets the user type code or commands and evaluates the result (by "evaluate" we don't mean "grade"). e.g.: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). - *Interactive Tutorials* : An interactive website which lets the user type code or commands and evaluates the result (by "evaluate" we don't mean "grade"). e.g.: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io).
- **JavaScript Resources** : Any resources teaching a JavaScript framework or library. - *JavaScript Resources* : Any resources teaching a JavaScript framework or library.
- **Problem Sets & Competitive Programming** : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users. - *Problem Sets & Competitive Programming* : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users.
4. Make sure to correctly [format](#formatting) your modifications. 4. Make sure to follow the [guidelines below](#guidelines) and respect the [Markdown formatting](#formatting) of the files
5. Read the guidelines below:
### Actual guidelines ### Guidelines
- make sure a book is free. Double-check if needed. - make sure a book is free. Double-check if needed.
- insert your links in alphabetical order. If you see a misplaced link, please reorder it and submit a PR - insert your links in alphabetical order. If you see a misplaced link, please reorder it and submit a PR
- use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website) - use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website)