Adding CONTRIBUTING.md. Using the new format for all the lists.

Author: matysanchez

CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Contribute to the lists
+Hello dear friend, welcome!
+This guide details how to contribute to this repository.
+
+
+## Contributor license agreement
+By submitting code you agree to the [LICENCE](/LICENSE) of this repository.
+
+
+## Everyone is welcome to add a new free book to the list
+Yep, that is true, you and your friends are welcome to add new free books to the list. And by free, we mean free, really free.
+And you know what? It's really easy, see below.
+
+
+## Steps to add a new book
+ Make sure that you've read [Contribution](https://github.com/vhf/free-programming-books/wiki/Contribution), which guides you to editing a repository. Then:
+
+1. Again, unlike other projects, we prefer multiple small commits rather than one large change in a pull request - it's fine to have one pull request, but please make sure your title reflects what you've changed.
+2. Use our standard for formatting the .md file. Check it out: [Formatting](#formatting)
+3. Please try to use alphabetic order.
+
+
+### Formatting
+We are adults. Let's respect the next standard.
++ All lists are ```.md``` files. Try to learn Github's Markdown syntax. It's simple!
++ All the lists start with an Index, the idea is to show all of sections and subsections there, so it's important to have an index for each section. Right now it's alphabetized, so please use alphabetic order.
++ Sections are using level 3 heading (in HTML is ```<h3>```, in Markdown is ```###```), and subsections are using level 4 (in Markdown is ####).
+
+The idea is to have
++ ```2``` empty lines between last suggested book & header 
++ ```0``` empty line between header & first book of that very section.
++ ```0``` empty line between each book in 1 section.
++ ```1``` empty line at the end of each ```.md``` file.
+
+Like this example:
+```
+[...]
+* [Essential Pascal Version 1 and 2](http://www.marcocantu.com/epascal/)
+
+
+###DTrace
+* [IllumOS Dynamic Tracing Guide](http://dtrace.org/guide/preface.html)
+* [Some Other Book](http://so.me/other/book.html)
+
+```
+
+And that's it! Simple, easy and lovely...
+
+We hope you contribute to this great repository. :+1:

README.md

@@ -1,9 +1,5 @@
-List of Free Learning Resources
-===
-
-Intro
----
-
+#List of Free Learning Resources
+##Intro
 If you want to find a learning resource, you should definitely check out our site, [Free Learning Resources](http://resrc.io).
 And for those who want to learn a computer language, you should check out these books on [reSRC.io](http://resrc.io/list/10/list-of-free-programming-books/) or on [github](/free-programming-books.md).
 This list initially was a clone of [stackoverflow - List of Freely Available Programming Books](http://stackoverflow.com/questions/194812/list-of-freely-available-programming-books/392926#392926) by George Stocker. Now updated, with dead links gone and new content.
@@ -12,7 +8,7 @@ Moved to GitHub for collaborative updating and for the site mentioned above.
 
 
 ### How To Contribute
-It's [easy](https://github.com/vhf/free-programming-books/wiki/Contribution).
+It's [easy](https://github.com/vhf/free-programming-books/wiki/Contribution). Please read [CONTRIBUTING](/CONTRIBUTING.md).
 - [Fork](https://help.github.com/articles/fork-a-repo)
 - Read the [TODO](/TODO.md) file(Adding new books is our #1 priority, but things like Alphabetizing are important, too.)
 - Edit (we prefer multiple small commits rather than one large change)
@@ -21,6 +17,7 @@ It's [easy](https://github.com/vhf/free-programming-books/wiki/Contribution).
 
 **Again, unlike other projects, we prefer multiple small commits rather than one large change in a pull request - it's fine to have one PR, but please make sure your title reflects what you're changing**, thanks.
 
+
 ### How to Share
 + [Share on Twitter](http://twitter.com/home?status=https://github.com/vhf/free-programming-books%0AFree%20Programming%20Books)
 + [Share on Facebook](http://www.facebook.com/sharer/sharer.php?s=100&p[url]=https://github.com/vhf/free-programming-books&p[images][0]=&p[title]=Free%20Programming%20Books&p[summary]=)
@@ -29,48 +26,29 @@ It's [easy](https://github.com/vhf/free-programming-books/wiki/Contribution).
 
 
 ### In Other Spoken Languages
-
 + Bulgarian: [github](/free-programming-books-bg.md)
-
 + Chinese: [github](/free-programming-books-zh.md)
-
 + French: [github](/free-programming-books-fr.md) or [site](http://resrc.io/list/33/livres-gratuits-sur-la-programmation/).
-
     The French list was based on <http://progdupeu.pl/forums/sujet/43/une-banque-de-liens>.
-
 + German: [github](/free-programming-books-de.md)
-
 + Greek: [github](/free-programming-books-gr.md)
-
 + Hungarian: [github](/free-programming-books-hu.md)
-
 + Italian: [github](/free-programming-books-it.md)
-
 + Japanese: [github](/free-programming-books-ja.md)
-
 + Korean: [github](/free-programming-books-ko.md)
-
 + Persian/Farsi (Iran): [github](/free-programming-books-fa_IR.md)
-
 + Polish: [github](/free-programming-books-pl.md)
-
 + Portuguese (Brazil): [github](/free-programming-books-pt_BR.md)
-
 + Portuguese (Portugal): [github](/free-programming-books-pt_PT.md)
-
 + Russian: [github](/free-programming-books-ru.md)
-
 + Turkish: [github](/free-programming-books-tr.md)
-
 + Spanish: [github](/free-programming-books-es.md)
-
 + Ukrainian: [github](/free-programming-books-ua.md)
 
-### Noticeable lists from [reSRC](http://resrc.io/)
 
+### Noticeable lists from [reSRC](http://resrc.io/)
 + Free JavaScript frameworks resources and tutorials: [github](/javascript-frameworks-resources.md) or [site](http://resrc.io/list/18/javascript-frameworks/)
 
 
 ### Interactive Programming Resources
-
 + Free interactive programming tutorials: [github](/free-programming-interactive-tutorials-en.md) or [site](http://resrc.io/list/217/programming-interactive-tutorials/)

TODO.md

@@ -16,7 +16,7 @@ TODO
 + ☐ : Alphabetizing the entries in the pages
     + ☐ : bg
     + ☐ : de
-    + ☐ : es
+    + ☑ : es
     + ☐ : en
     + ☑ : fa_IR
     + ☐ : fr
@@ -32,4 +32,4 @@ TODO
 
 Map:
 ☑ : Done
-☐ : In progress
+☐ : In progress

free-programming-books-bg.md

@@ -1,9 +1,8 @@
 ###Index
-
 * [Въведение в програмирането, алгоритми](#Въведение в програмирането, алгоритми)
 
-###Въведение в програмирането, алгоритми
 
+###Въведение в програмирането, алгоритми
 * [Въведение в програмирането със С#](http://www.introprogramming.info/wp-content/uploads/2011/07/Intro-CSharp-Book-1.00.pdf) -  С. Наков
 * [Програмиране = ++ Алгоритми](http://www.programirane.org/2013/02/free-download-algo-book-nakov-dobrikov/) - Преслав Наков и Панайот Добриков
 * [Въведение в програмирането с Java](http://www.introprogramming.info/intro-java-book/read-online/) - С. Наков 

free-programming-books-de.md

@@ -22,123 +22,122 @@
 * [Unix](#unix)
 * [Visual Basic](#visual-basic)
 
-###Unabhängig von der Programmiersprache
 
+###Unabhängig von der Programmiersprache
 * [IT-Handbuch für Fachinformatiker](http://openbook.galileocomputing.de/it_handbuch/)
 * [Objektorientierte Programmierung](http://openbook.galileocomputing.de/oop/)
 * [Scrum und XP im harten Projektalltag](http://www.infoq.com/resource/news/2007/06/scrum-xp-book/en/resources/ScrumAndXpFromTheTrenchesonline_German.pdf)
 
-###Action Script
 
+###Action Script
 * [ActionScript 1 und 2](http://openbook.galileodesign.de/actionscript/)
 * [Einstieg in ActionScript](http://openbook.galileodesign.de/actionscript_einstieg/)
 
-###Android
 
+###Android
 * [Grundlagen und Programmierung](http://www.dpunkt.de/ebooks_files/free/3436.pdf)
 
-###Assembly Language
 
+###Assembly Language
 * [PC Assembly Language](http://drpaulcarter.com/pcasm/) - Paul A. Carter
 
 
 ###C
-
 * [C von A bis Z](http://openbook.galileocomputing.de/c_von_a_bis_z/)
 * [Softwareentwicklung in C](http://www.klausschmaranz.com/Downloads/SoftwareentwicklungInC.pdf)
 
-###C++
 
+###C++
 * [Die Boost C++ Bibliotheken](http://www.highscore.de/cpp/boost/)
 * [Programmieren in C++: Einführung](http://www.highscore.de/cpp/einfuehrung/)
 * [Programmieren in C++: Aufbau](http://www.highscore.de/cpp/aufbau/)
 
-###C Sharp
 
+###C Sharp
 * [Programmieren in C#: Einführung](http://www.highscore.de/csharp/einfuehrung/)
 * [Visual C# 2012](http://openbook.galileocomputing.de/visual_csharp_2012/)
 * [Visual C# 2010](http://openbook.galileocomputing.de/visual_csharp_2010/)
 * [Visual C# 2008](http://openbook.galileocomputing.de/visual_csharp/)
 
-###iOS
 
+###iOS
 * [Apps programmieren für iPhone und iPad](http://openbook.galileocomputing.de/apps_programmieren_fuer_iphone_und_ipad/)
 * [iOS-Rezepte](http://examples.oreilly.de/openbooks/iosrecipesger.zip)
 * [iPad-Programmierung](http://examples.oreilly.de/openbooks/pdf_ipadprogpragger.pdf)
 
-###Git
 
+###Git
 * [Git Magic](http://www-cs-students.stanford.edu/~blynn/gitmagic/intl/de/)
 * [Pro Git](http://git-scm.com/book/de)
 
-###Groovy
 
+###Groovy
 * [Groovy für Java-Entwickler](http://examples.oreilly.de/openbooks/pdf_groovyger.pdf)
 
-### HTML & CSS
 
+### HTML & CSS
 * [HTML5-Handbuch](http://webkompetenz.wikidot.com/docs:html-handbuch)
 * [Self HTML](http://de.selfhtml.org/)
 
-###Java
 
+###Java
 * [EJB 3 für Umsteiger: Neuerungen und Änderungen gegenüber dem EJB-2.x-Standard](http://bsd.de/e3fu/umfrage.html) - Heiko W. Rupp
 * [Java 7 Mehr als eine Insel](http://openbook.galileocomputing.de/java7/)
 * [Java ist auch eine Insel](http://openbook.galileocomputing.de/javainsel/)
 * [JSFAtWork, JSF 2.0 und Apache MyFaces](http://jsfatwork.irian.at/book_de/)
 * [Programmieren Java: Einführung](http://www.highscore.de/java/einfuehrung/)
 * [Programmieren Java: Aufbau](http://www.highscore.de/java/aufbau/)
 
-###Javascript
 
+###Javascript
 * [JavaScript und AJAX](http://openbook.galileocomputing.de/javascript_ajax/)
 * [Webseiten erstellen mit Javascript](http://www.highscore.de/javascript/)
 
-###LaTeX
 
+###LaTeX
 * [LaTeX : Referenz der Umgebungen, Makros, Längen und Zähler](http://www.lehmanns.de/page/latexreferenz/)
 
+
 ###Meta-Lists
 * [Galileo Computing - openbook](http://www.galileocomputing.de/katalog/openbook)
 
 
 ###PHP
-
 * [PHP PEAR](http://openbook.galileocomputing.de/php_pear/)
 * [Praktischer Einstieg in MySQL mit PHP](http://examples.oreilly.de/openbooks/pdf_einmysql2ger.pdf)
 
-###Python
 
+###Python
 * [Python Das umfassende Handbuch](http://openbook.galileocomputing.de/python/)
 
-###Ruby
 
+###Ruby
 * [Programmieren mit Ruby](http://approximity.com/rubybuch2/)
 * [Ruby on Rails 2](http://openbook.galileocomputing.de/ruby_on_rails/)
 
-###Ruby on Rails
 
+###Ruby on Rails
 * [Praxiswissen Ruby](http://www.oreilly.de/german/freebooks/rubybasger/pdf_rubybasger.pdf)
 * [Praxiswissen Ruby On Rails](http://examples.oreilly.de/openbooks/pdf_rubyonrailsbasger.pdf)
 * [Rails Kochbuch](http://examples.oreilly.de/openbooks/pdf_railsckbkger.pdf)
 * [Ruby on Rails 2](http://openbook.galileocomputing.de/ruby_on_rails/)
 
-###Scilab
 
+###Scilab
 * [Einführung in Scilab/Xcos 5.4](http://www.buech-gifhorn.de/scilab/Einfuehrung.pdf)
 
-###UML
 
+###UML
 * [Der moderne Softwareentwicklungsprozess mit UML](http://www.highscore.de/uml)
 
-###Unix
 
+###Unix
 * [Linux-UNIX-Programmierung](http://openbook.galileocomputing.de/linux_unix_programmierung/)
 * [Shell-Programmierung](http://openbook.galileocomputing.de/shell_programmierung/)
 * [Wie werde ich Unix Guru?](http://openbook.galileocomputing.de/unix_guru/)
 
-###Visual Basic
 
+###Visual Basic
 * [Einstieg in Visual Basic 2012](http://openbook.galileocomputing.de/einstieg_vb_2012/)
 * [Einstieg in Visual Basic 2010](http://openbook.galileocomputing.de/einstieg_vb_2010/)
 * [Visual Basic 2008](http://openbook.galileocomputing.de/visualbasic_2008/)