diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 466f96d..82d0485 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,12 +1,12 @@ ## The Goal -Our goal is not to have the biggest list of stuff. +Our goal is not to have the biggest list of stuff. Our goal is to have a **comprehensible** list of most valuable things any programmer should know about. ## Contributing -Your contributions to this repo are always welcome! -Bear in mind, that this repo is *highly opinionated* and *curated*. -Your opinion on value of any resource may not match the opinion of curator. +Your contributions to this repo are always welcome! +Bear in mind, that this repo is *highly opinionated* and *curated*. +Your opinion on value of any resource may not match the opinion of curator. **No PR will be discarded without explanations!** @@ -18,7 +18,7 @@ Your opinion on value of any resource may not match the opinion of curator. We :heart: simplicity.
We :heart: essential stuff.
-This is why we strive to having less, but most valuable resources in the list. +We strive to have a smaller list of more valuable resources, quality over quantity.

We :heart: widely applicable knowledge/skills.

@@ -47,25 +47,25 @@ This is why resources on soft skills are an essential part of that list.

Do not add things you have not evaluated personally!

-Use your critical thinking to filter out non-essential stuff. -Give honest arguments for why the resource should be included. -Have you read this book? -Can you give a short article? +Use your critical thinking to filter out non-essential stuff. +Give honest arguments for why the resource should be included. +Have you read this book? +Can you give a short article?

Use reasoning based on our values.

-Before adding any resource, answer this questions to yourself: -- Will it make every programmer a better human being? -- Will it change the quality of programmer's work? -- Will it change the quality of programmer's life? +Before adding any resource, answer this questions to yourself: +- Will it make every programmer a better human being? +- Will it change the quality of programmer's work? +- Will it change the quality of programmer's life? - Would you personally recommend this resource to your friend, starting on software development career?

One item per Pull Request.

-There may be a discussion related to an item you want to add. +There may be a discussion related to an item you want to add. Adding just a single item per pull request makes it much easier for everyone involved.

@@ -76,11 +76,11 @@ It is just easier to discuss and decide on a resource within a Pull Request.
Use consistent set of resource type emoji

-🎥 - Video/Talk -📖 - Book -📄 - Online article -📜 - Paper/Document -✅ - Checklist +🎥 - Video/Talk +📖 - Book +📄 - Online article +📜 - Paper/Document +✅ - Checklist