knowledge/programming-books
1
0
Fork 0
mirror of https://github.com/namibia/free-programming-books.git synced 2024-11-22 19:45:09 +00:00
Code Issues Releases Activity

Implement "In process" formatting (#2538)

Browse Source 
* implement #2357

* Jane Roe is an awesome writer

also, her website is secure!
This commit is contained in:
eshellman 2017-10-02 10:40:16 -04:00 committed by GitHub
parent b64a0a9333
commit 89eff3cb87
1 changed files with 14 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
CONTRIBUTING.md
View File

@ -42,6 +42,7 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb
- prefer atomic commits (one commit by addition/deletion/modification) over bigger commits. No need to squash your commits before submitting a PR. (We will never enforce this rule as it's just a matter of convenience for the maintainers) - prefer atomic commits (one commit by addition/deletion/modification) over bigger commits. No need to squash your commits before submitting a PR. (We will never enforce this rule as it's just a matter of convenience for the maintainers)
- if the book is older, include the publication date with the title. - if the book is older, include the publication date with the title.
- include the author name or names where appropriate. You can shorten author lists with "et al." - include the author name or names where appropriate. You can shorten author lists with "et al."
- if the book is not finished, and is still being worked on, add the "in process" notation, as described [below.](#in_process)
### Formatting ### Formatting
- All lists are `.md` files. Try to learn [Markdown](https://guides.github.com/features/mastering-markdown/) syntax. It's simple! - All lists are `.md` files. Try to learn [Markdown](https://guides.github.com/features/mastering-markdown/) syntax. It's simple!
@ -82,15 +83,15 @@ GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe
- Put a single space between the link and its format - Put a single space between the link and its format
``` ```
BAD : * [Another Awesome Book](http://example.com/book.pdf)(PDF) BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF)
GOOD: * [Another Awesome Book](http://example.com/book.pdf) (PDF) GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF)
``` ```
- Author comes before format: - Author comes before format:
``` ```
BAD : * [Another Awesome Book](http://example.com/book.pdf)- John Doe BAD : * [A Very Awesome Book](https://example.org/book.pdf)- Jane Roe
GOOD: * [Another Awesome Book](http://example.com/book.pdf) - John Doe (PDF) GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
``` ```
- Multiple formats: - Multiple formats:
@ -104,6 +105,13 @@ GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPU
- Include publication year in title for older books: - Include publication year in title for older books:
``` ```
BAD: * [Another Awesome Book](http://example.com/book.html) - John Doe - 1970 BAD: * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970
GOOD: * [Another Awesome Book (1970)](http://example.com/book.html) - John Doe GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe
```
<a name="in_process"></a>
- In-process books
```
GOOD: * [Will Be Awesome Soon Book](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
``` ```