Skip to content

Commit

Permalink
Merge branch 'feature/books'
Browse files Browse the repository at this point in the history
  • Loading branch information
shaisachs committed Jan 28, 2024
2 parents 76358d3 + c3ae8bc commit 7b49afd
Show file tree
Hide file tree
Showing 20 changed files with 110 additions and 5 deletions.
5 changes: 5 additions & 0 deletions _books/accelerate.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: Accelerate
authors: Nicole Forsgren, Jez Humble, Gene Kim
link: https://www.amazon.com/Accelerate-Software-Performing-Technology-Organizations/dp/1942788339?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=b66c308183d75fd1445835439b2405a4&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/build-apis-you-wont-hate.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Build APIs You Won't Hate"
authors: Phil Sturgeon, Laura Bohill
link: https://www.amazon.com/Build-APIs-You-Wont-Hate/dp/0692232699?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=ef2190b6dd21b969993d3377497ad83f&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/c-programming-language.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: The C Programming Language
authors: Dennis Ritchie, Brian Kernighan
link: https://www.amazon.com/Programming-Language-2nd-Brian-Kernighan/dp/0131103628/?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=25d2a590858b9aff44069d6b0cfcf84c&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/cathedral-and-bazaar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "The Cathedral & the Bazaar: Musings On Linux And Open Source By An Accidental Revolutionary"
authors: Eric S. Raymond
link: https://www.amazon.com/Cathedral-Bazaar-Musings-Accidental-Revolutionary/dp/0596001088?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=f6fd5393e16732fd608e42e74fa05f4d&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/code-complete.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Code Complete: A Practical Handbook of Software Construction"
authors: Steve McConnell
link: https://www.amazon.com/Code-Complete-Practical-Handbook-Construction/dp/0735619670?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=307310d6ba930d1c08d168f2a1c2cdc1&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/design-patterns.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Design Patterns: Elements of Reusable Object-Oriented Software"
authors: Erich Gamma, Richard Helm, Ralph Johnson, John Vlissides, Grady Booch
link: https://www.amazon.com/gp/product/0201633612/?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=80bc0a0c027915e6a13ee58c37fd3842&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/designing-data-intensive-applications.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: Designing data-intensive applications
authors: Martin Kleppmann
link: https://www.amazon.com/Designing-Data-Intensive-Applications-Reliable-Maintainable/dp/1449373321/?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=cd8ef35586594cf4b33a331fdc8425bd&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/elegant-puzzle.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: An Elegant Puzzle
authors: Will Larson
link: https://www.amazon.com/Elegant-Puzzle-Systems-Engineering-Management/dp/B07SH1DXXM/?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=4b86157e87c172dbaf8515b82ccf05a0&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/elements-of-programming-style.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: The Elements of Programming Style
authors: Brian W. Kernighan, P.J. Plauger
link: https://www.amazon.com/Elements-Programming-Style-2nd/dp/0070342075/?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=39fc55b6042cc45ae5a739e6861b1a86&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/elements-of-style.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: Elements of Style
authors: William Strunk, E. White
link: https://www.amazon.com/Elements-Style-4th-William-Strunk/dp/B0BYRNBRZ3/?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=dd1669d350a211a9abcb856c8ca323a7&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/emergent-design.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: Emergent Design
authors: Scott L. Bain
link: https://www.amazon.com/Emergent-Design-Evolutionary-Professional-Development/dp/0321509366/?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=97997ccd5ec8b065b72cc157c64d0922&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/mythical-man-month.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: The Mythical Man-Month
authors: Fred Brooks
link: "https://www.amazon.com/Mythical-Man-Month-Software-Engineering-Anniversary/dp/0201835959?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=175e9c6c1c8766c1ff56f05c2f7469e8&camp=1789&creative=9325"
---
5 changes: 5 additions & 0 deletions _books/staff-engineers-path.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "The Staff Engineer's Path: A Guide for Individual Contributors Navigating Growth and Change"
authors: Tanya Reilly
link: https://www.amazon.com/Staff-Engineers-Path-Individual-Contributors/dp/1098118731?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=fd8368c2876fed3cb8f852866f3080a0&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/thinking-fast-and-slow.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: Thinking, Fast and Slow
authors: Daniel Kahneman
link: https://www.amazon.com/Thinking-Fast-Slow-Daniel-Kahneman/dp/0374533555?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=a281e4e1fd18dabe6c38bce81f6365af&camp=1789&creative=9325
---
5 changes: 5 additions & 0 deletions _books/thinking-in-systems.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: Thinking in Systems
authors: Donella Meadows, Diana Wright
link: https://www.amazon.com/Thinking-in-Systems-audiobook/dp/B07FW9Z4KG/?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=4e721fbbf2ea6fb47ad939a575c656a3&camp=1789&creative=9325
---
4 changes: 3 additions & 1 deletion _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -30,4 +30,6 @@ exclude: ["node_modules", "gulpfile.js", "package.json", "yarn.lock"]

collections:
laws:
output: true
output: true
books:
output: false
1 change: 0 additions & 1 deletion _laws/gall.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@ title: Gall's Law
law: A complex system that works has evolved from a simple system that worked. A complex system built from scratch won’t work.
law-author: John Gall
law-url: https://www.amazon.com/SYSTEMANTICS-SYSTEMS-BIBLE-John-Gall-ebook/dp/B00AK1BIDM?&_encoding=UTF8&tag=lawsofsoftwar-20&linkCode=ur2&linkId=55d61fcdfabf182924a164860124a790&camp=1789&creative=9325
https://www.goodreads.com/book/show/583785.The_Systems_Bible
law-year: 1975
---

Expand Down
7 changes: 6 additions & 1 deletion _layouts/main.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,12 @@
<a href="{{site.baseurl}}/"><img src="{{site.baseurl}}/assets/img/{% if site.site-img %}{{site.site-img}}{% endif %}" alt="{{site.title}}"></a>
</div>
<div class="site-name">{{site.title}}</div>
<p><a href="{{site.baseurl}}/about">About</a> - <a href="https://github.com/shaisachs/laws-of-software">Contribute</a></p>
<p><a href="{{site.baseurl}}/">Laws</a> -
<a href="{{ site.baseurl}}/books">Books</a>
</p>
<p><a href="{{site.baseurl}}/about">About</a> -
<a href="https://github.com/shaisachs/laws-of-software">Contribute</a>
</p>
</div>
</header> <!-- End Header -->
<footer>
Expand Down
12 changes: 10 additions & 2 deletions api.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,16 @@
"author": "{{ post.law-author }}",
"year": {{ post.law-year }},
"source": "{{ post.law-url }}"
}
{% if post.next %},{% endif %}
} {% if post.next %},{% endif %}
{% endfor %}
],
"books": [
{% for book in site.books %}
{
"title": "{{ book.title }}",
"url": "{{ book.link }}",
"authors": "{{ book.authors }}"
} {% if book.next %},{% endif %}
{% endfor %}
]
}
16 changes: 16 additions & 0 deletions books.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
layout: main
---

<p>For those interested in the art and science of software development, nothing beats reading some of the classic works in the field. These books are excellent complements to the laws of software development; they help fill out a robust picture of software architecture from numerous angles.</p>

<p>Not all of these books are strictly focused on the practice of software as such. That is because skilled software developers draw their talents from many disciplines, ranging from literature to the social sciences. A broad view of the world at large is the best way to approach this fascinating field.</p>

{% for post in site.books %}
<article class="post">
<div class="post-content">
<h2 class="post-title"><a href="{{post.link}}" target=_blank>{{post.title}}</a></h2>
<p>by {{post.authors}}</p>
</div>
</article>
{% endfor %}

0 comments on commit 7b49afd

Please sign in to comment.