From 4b6af52e6061e5e0bb7355b9110ae6c0cf88de03 Mon Sep 17 00:00:00 2001 From: Jeff Nickoloff Date: Tue, 14 May 2019 14:17:31 -0700 Subject: [PATCH 01/37] feat: Dunbar's number feat: Added Dunbar's number --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 71f3a43..92e62e2 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [Amdahl's Law](#amdahls-law) * [Brooks's Law](#brookss-law) * [Conway's Law](#conways-law) + * [Dunbar's Number](#dunbars-number) * [Hofstadter's Law](#hofstadters-law) * [The Hype Cycle & Amara's Law](#the-hype-cycle--amaras-law) * [Hyrum's Law (The Law of Implicit Interfaces)](#hyrums-law-the-law-of-implicit-interfaces) @@ -90,6 +91,18 @@ See also: - [The Spotify Model](#the-spotify-model) +### Dunbar's Number + +[Dunbar's Number on Wikipedia](https://en.wikipedia.org/wiki/Dunbar%27s_number) + +"Dunbar's number is a suggested cognitive limit to the number of people with whom one can maintain stable social relationships— relationships in which an individual knows who each person is and how each person relates to every other person." There is some disagreement to the exact number. "... [Dunbar] proposed that humans can comfortably maintain only 150 stable relationships." He put the number into a more social context, "the number of people you would not feel embarrassed about joining uninvited for a drink if you happened to bump into them in a bar." Estimates for the number generally lay between 100 and 250. + +Like stable relationships between individuals, a developer's relationship with a codebase takes effort to maintain. When faced with large complicated projects, or ownership of many projects we lean on convention, policy, and modeled procedure to scale. Dunbar's number is not only important to keep in mind as an office grows, but also when setting the scope for team efforts or deciding when a system should invest in tooling to assist in modeling and automating logistical overhead. Putting the number into an engineering context, it is the number of projects (or normalized complexity of a single project) for which you would feel confident in joining an on-call rotation to support. + +See also: + +- [Conway's Law](#conways-law) + ### Hofstadter's Law [Hofstadter's Law on Wikipedia](https://en.wikipedia.org/wiki/Hofstadter%27s_law) From d6ab3af6f6b3de151537a6f11bb1c2abf16abaa9 Mon Sep 17 00:00:00 2001 From: Ryan Rix Date: Tue, 14 May 2019 16:56:59 -0700 Subject: [PATCH 02/37] Add Hutber's Law It's an awfully cynical one, but it's a failure I've seen in the wild more times than I'd like to count. --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index 71f3a43..b8b87f7 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [Brooks's Law](#brookss-law) * [Conway's Law](#conways-law) * [Hofstadter's Law](#hofstadters-law) + * [Hutber's Law](#hutbers-law) * [The Hype Cycle & Amara's Law](#the-hype-cycle--amaras-law) * [Hyrum's Law (The Law of Implicit Interfaces)](#hyrums-law-the-law-of-implicit-interfaces) * [Moore's Law](#moores-law) @@ -98,6 +99,14 @@ See also: You might hear this law referred to when looking at estimates for how long something will take. It seems a truism in software development that we tend to not be very good at accurately estimating how long something will take to deliver. +### Hutber's Law + +[Hutber's Law on Wikipedia](https://en.wikipedia.org/wiki/Hutber%27s_law) + +> Improvement means deterioration. + +This law suggests that improvements to a system will lead to deterioration in other parts, or it will hide other deterioration, leading overall to a degredation from the current state of the system. For example, a decrease in response latency for a particular end-point could cause increased throughput and capacity issues further along in a request flow, effecting an entirely different sub-system. + ### The Hype Cycle & Amara's Law [The Hype Cycle on Wikipedia](https://en.wikipedia.org/wiki/Hype_cycle) From abfb8de55c6f44c621d90d44bade6c53671c45d4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bal=C3=A1zs=20Richer?= Date: Sat, 18 May 2019 10:42:22 +0200 Subject: [PATCH 03/37] Added Pareto Principle. --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index 13d62dd..c5d9b61 100644 --- a/README.md +++ b/README.md @@ -155,6 +155,25 @@ See also: Often used to illustrate the sheer speed at which semiconductor and chip technology has improved, Moore's prediction has proven to be highly accurate over from the 1970s to the late 2000s. In more recent years, the trend has changed slightly, partly due to [physical limitations on the degree to which components can be miniaturised](https://en.wikipedia.org/wiki/Quantum_tunnelling). However, advancements in parallelisation, and potentially revolutionary changes in semiconductor technology and quantum computing may mean that Moore's Law could continue to hold true for decades to come. +### Pareto principle + +[Pareto principle on Wikipedia](https://en.wikipedia.org/wiki/Pareto_principle) + +>Most things in life are not distributed evenly. + +The Pareto Principle helps you realize that the majority of results come from a minority of inputs: + - 80% of a certain piece of software can be written in 20% of the total allocated time (conversely, the hardest 20% of the code takes 80% of the time) +- 20% of the effort produce 80% of the result +- 20% of the work create 80% of the revenue +- 20% of the bugs cause 80% of the crashes +- 20% of the features cause 80% of the usage + +In the 1940s American-Romanian engineer Dr. Joseph Juran, who is widely credited with being the father of quality control, [began to apply the Pareto principle to quality issues](https://en.wikipedia.org/wiki/Joseph_M._Juran). + +Real-world example: + +In 2002 Microsoft reported that by fixing the top 20% of the most-reported bugs, 80% of the related errors and crashes in windows and office would become eliminated. + ### Parkinson's Law [Parkinson's Law on Wikipedia](https://en.wikipedia.org/wiki/Parkinson%27s_law) From 0c1c4fa04dce7f301b5c41c1e61ea04eba34d93b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bal=C3=A1zs=20Richer?= Date: Sat, 18 May 2019 10:43:56 +0200 Subject: [PATCH 04/37] Added Pareto Principle to table of contents. --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index c5d9b61..063d144 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [The Hype Cycle & Amara's Law](#the-hype-cycle--amaras-law) * [Hyrum's Law (The Law of Implicit Interfaces)](#hyrums-law-the-law-of-implicit-interfaces) * [Moore's Law](#moores-law) + * [Pareto principle](#pareto-principle) * [Parkinson's Law](#parkinsons-law) * [Putt's Law](#putts-law) * [The Law of Conservation of Complexity (Tesler's Law)](#the-law-of-conservation-of-complexity-teslers-law) From 46bfe090aae12127a5c77d0594d99963043c2597 Mon Sep 17 00:00:00 2001 From: itallmakesense Date: Sat, 18 May 2019 17:52:30 +0300 Subject: [PATCH 05/37] add `Premature Optimization Effect` to the `Laws` --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 9d38c67..c0d62c2 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [Hyrum's Law (The Law of Implicit Interfaces)](#hyrums-law-the-law-of-implicit-interfaces) * [Moore's Law](#moores-law) * [Parkinson's Law](#parkinsons-law) + * [Premature Optimization Effect](#premature-optimization-effect) * [Putt's Law](#putts-law) * [The Law of Conservation of Complexity (Tesler's Law)](#the-law-of-conservation-of-complexity-teslers-law) * [The Law of Leaky Abstractions](#the-law-of-leaky-abstractions) @@ -173,6 +174,18 @@ See also: - [Hofstadter's Law](#hofstadters-law) +### Premature Optimization Effect + +[Source](http://wiki.c2.com/?PrematureOptimization) + +> Premature optimization is the root of all evil. +> +> Donald Knuth + +In Donald Knuth's paper [Structured Programming With Go To Statements](http://wiki.c2.com/?StructuredProgrammingWithGoToStatements), he wrote: "Programmers waste enormous amounts of time thinking about, or worrying about, the speed of noncritical parts of their programs, and these attempts at efficiency actually have a strong negative impact when debugging and maintenance are considered. We should forget about small efficiencies, say about 97% of the time: **premature optimization is the root of all evil**. Yet we should not pass up our opportunities in that critical 3%." + +However, _Premature Optimization_ can be defined (in less loaded terms) as optimizing before we know that we need to. + ### Putt's Law [Putt's Law on Wikipedia](https://en.wikipedia.org/wiki/Putt%27s_Law_and_the_Successful_Technocrat) From d8bd0d36753b2efdd3d07ea9f8633b47e7ae19be Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Wed, 22 May 2019 23:35:50 +0800 Subject: [PATCH 06/37] docs: minor edits of pareto princple --- README.md | 45 ++++++++++++++++++++++++--------------------- 1 file changed, 24 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 72faa18..61daf03 100644 --- a/README.md +++ b/README.md @@ -9,14 +9,13 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [Introduction](#introduction) * [Laws](#laws) * [Amdahl's Law](#amdahls-law) - * [Brooks' Law](#brookss-law) + * [Brooks' Law](#brooks-law) * [Conway's Law](#conways-law) * [Hanlon's Razor](#hanlons-razor) * [Hofstadter's Law](#hofstadters-law) * [The Hype Cycle & Amara's Law](#the-hype-cycle--amaras-law) * [Hyrum's Law (The Law of Implicit Interfaces)](#hyrums-law-the-law-of-implicit-interfaces) * [Moore's Law](#moores-law) - * [Pareto principle](#pareto-principle) * [Parkinson's Law](#parkinsons-law) * [Putt's Law](#putts-law) * [The Law of Conservation of Complexity (Tesler's Law)](#the-law-of-conservation-of-complexity-teslers-law) @@ -26,6 +25,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [The Spotify Model](#the-spotify-model) * [Wadler's Law](#wadlers-law) * [Principles](#principles) + * [The Pareto Principle (The 80/20 Rule)](#the-pareto-principle-the-8020-rule) * [The Robustness Principle (Postel's Law)](#the-robustness-principle-postels-law) * [SOLID](#solid) * [The Single Responsibility Principle](#the-single-responsibility-principle) @@ -167,25 +167,6 @@ See also: Often used to illustrate the sheer speed at which semiconductor and chip technology has improved, Moore's prediction has proven to be highly accurate over from the 1970s to the late 2000s. In more recent years, the trend has changed slightly, partly due to [physical limitations on the degree to which components can be miniaturised](https://en.wikipedia.org/wiki/Quantum_tunnelling). However, advancements in parallelisation, and potentially revolutionary changes in semiconductor technology and quantum computing may mean that Moore's Law could continue to hold true for decades to come. -### Pareto principle - -[Pareto principle on Wikipedia](https://en.wikipedia.org/wiki/Pareto_principle) - ->Most things in life are not distributed evenly. - -The Pareto Principle helps you realize that the majority of results come from a minority of inputs: - - 80% of a certain piece of software can be written in 20% of the total allocated time (conversely, the hardest 20% of the code takes 80% of the time) -- 20% of the effort produce 80% of the result -- 20% of the work create 80% of the revenue -- 20% of the bugs cause 80% of the crashes -- 20% of the features cause 80% of the usage - -In the 1940s American-Romanian engineer Dr. Joseph Juran, who is widely credited with being the father of quality control, [began to apply the Pareto principle to quality issues](https://en.wikipedia.org/wiki/Joseph_M._Juran). - -Real-world example: - -In 2002 Microsoft reported that by fixing the top 20% of the most-reported bugs, 80% of the related errors and crashes in windows and office would become eliminated. - ### Parkinson's Law [Parkinson's Law on Wikipedia](https://en.wikipedia.org/wiki/Parkinson%27s_law) @@ -303,6 +284,28 @@ See also: Principles are generally more likely to be guidelines relating to design. +### The Pareto Principle (The 80/20 Rule) + +[The Pareto Principle on Wikipedia](https://en.wikipedia.org/wiki/Pareto_principle) + +> Most things in life are not distributed evenly. + +The Pareto Principle suggests that in some cases, the majority of results come from a minority of inputs: + +- 80% of a certain piece of software can be written in 20% of the total allocated time (conversely, the hardest 20% of the code takes 80% of the time) +- 20% of the effort produces 80% of the result +- 20% of the work creates 80% of the revenue +- 20% of the bugs cause 80% of the crashes +- 20% of the features cause 80% of the usage + +In the 1940s American-Romanian engineer Dr. Joseph Juran, who is widely credited with being the father of quality control, [began to apply the Pareto principle to quality issues](https://en.wikipedia.org/wiki/Joseph_M._Juran). + +This principle is also known as: The 80/20 Rule, The Law of the Vital Few and The Principle of Factor Sparsity. + +Real-world examples: + +- In 2002 Microsoft reported that by fixing the top 20% of the most-reported bugs, 80% of the related errors and crashes in windows and office would become eliminated ([Reference](https://www.crn.com/news/security/18821726/microsofts-ceo-80-20-rule-applies-to-bugs-not-just-features.htm)). + ### The Robustness Principle (Postel's Law) [The Robustness Principle on Wikipedia](https://en.wikipedia.org/wiki/Robustness_principle) From f66c367e2dd563be18eece3c19b5854332c8de4d Mon Sep 17 00:00:00 2001 From: Ryan Rix Date: Fri, 24 May 2019 10:46:55 -0700 Subject: [PATCH 07/37] Remove ToC change per pull-request checklist --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index b8b87f7..b9d58f3 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,6 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [Brooks's Law](#brookss-law) * [Conway's Law](#conways-law) * [Hofstadter's Law](#hofstadters-law) - * [Hutber's Law](#hutbers-law) * [The Hype Cycle & Amara's Law](#the-hype-cycle--amaras-law) * [Hyrum's Law (The Law of Implicit Interfaces)](#hyrums-law-the-law-of-implicit-interfaces) * [Moore's Law](#moores-law) From 87c958ce810bd2ed4239c831bad29214e4ffd567 Mon Sep 17 00:00:00 2001 From: Nuno Barreiro Date: Mon, 27 May 2019 15:26:17 +0100 Subject: [PATCH 08/37] added YAGNI to list of principles --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index 61daf03..d02b83b 100644 --- a/README.md +++ b/README.md @@ -34,6 +34,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [The Interface Segregation Principle](#the-interface-segregation-principle) * [The Dependency Inversion Principle](#the-dependency-inversion-principle) * [The DRY Principle](#the-dry-principle) + * [YAGNI](#yagni) * [Reading List](#reading-list) * [TODO](#todo) @@ -431,6 +432,16 @@ See also: - [The Pragmatic Developer](https://en.wikipedia.org/wiki/The_Pragmatic_Programmer) +### YAGNI + +This is an acronym for _**Y**ou **A**ren't **G**onna **N**eed **I**t_ + +This Extreme Programming (XP) principle tells developers that they should only implement functionality that is required for the immediate present and avoid attempts to predict the future by implementing functionality that won't be used immediately, rather implement it only when deemed necessary. + +Some of the issues a developer can be faced with in a project that does not respect this principle are: +* Unnecessary increase of the overall codebase size with unused code; +* Time and productivity wasted on functionality that brings no value + ## Reading List If you have found these concepts interesting, you may enjoy the following books. From 87932e6d01bdbe73893fec0e23d152ad97765580 Mon Sep 17 00:00:00 2001 From: Nuno Barreiro Date: Mon, 27 May 2019 15:36:03 +0100 Subject: [PATCH 09/37] YAGNI principle - include quote and wiki article --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index d02b83b..518d627 100644 --- a/README.md +++ b/README.md @@ -436,12 +436,16 @@ See also: This is an acronym for _**Y**ou **A**ren't **G**onna **N**eed **I**t_ +> "Always implement things when you actually need them, never when you just foresee that you need them." - _[Ron Jeffries](https://twitter.com/RonJeffries) (XP co-founder and author of the book "Extreme Programming Installed")_ + This Extreme Programming (XP) principle tells developers that they should only implement functionality that is required for the immediate present and avoid attempts to predict the future by implementing functionality that won't be used immediately, rather implement it only when deemed necessary. Some of the issues a developer can be faced with in a project that does not respect this principle are: * Unnecessary increase of the overall codebase size with unused code; * Time and productivity wasted on functionality that brings no value +_[Check YAGNI article on Wikipedia](https://en.wikipedia.org/wiki/You_aren%27t_gonna_need_it)_ + ## Reading List If you have found these concepts interesting, you may enjoy the following books. From da8ec03813319a1cabd399737fb45323efaae182 Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Sat, 1 Jun 2019 17:22:05 +0800 Subject: [PATCH 10/37] docs: add link to korean version Fixes #114. --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 6481721..23bd59a 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,9 @@ Laws, Theories, Principles and Patterns that developers will find useful. 🇨🇳 [中文 / Chinese Version](https://github.com/nusr/hacker-laws-zh) - thanks [Steve Xu](https://github.com/nusr)! +🇰🇷 [한국어 / Korean Version](https://github.com/codeanddonuts/hacker-laws-kr) - thanks [Doughnut](https://github.com/codeanddonuts)! + +--- From 1af5af643cfa3cc1a64950fadcac5fe2a62e39ae Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Sat, 1 Jun 2019 17:23:32 +0800 Subject: [PATCH 11/37] chore: fix indents --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 23bd59a..c79926b 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,8 @@ Laws, Theories, Principles and Patterns that developers will find useful. -🇨🇳 [中文 / Chinese Version](https://github.com/nusr/hacker-laws-zh) - thanks [Steve Xu](https://github.com/nusr)! -🇰🇷 [한국어 / Korean Version](https://github.com/codeanddonuts/hacker-laws-kr) - thanks [Doughnut](https://github.com/codeanddonuts)! +- 🇨🇳 [中文 / Chinese Version](https://github.com/nusr/hacker-laws-zh) - thanks [Steve Xu](https://github.com/nusr)! +- 🇰🇷 [한국어 / Korean Version](https://github.com/codeanddonuts/hacker-laws-kr) - thanks [Doughnut](https://github.com/codeanddonuts)! --- From 6988abff1e3f17763cc99bfc6bf5293c5b05c670 Mon Sep 17 00:00:00 2001 From: Matthias Zeis Date: Sun, 2 Jun 2019 14:59:48 +0200 Subject: [PATCH 12/37] Fix link to Brook's Law --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c79926b..adea7d8 100644 --- a/README.md +++ b/README.md @@ -451,7 +451,7 @@ See also: If you have found these concepts interesting, you may enjoy the following books. -- [The Mythical Man Month - Frederick P. Brooks Jr.](https://www.goodreads.com/book/show/13629.The_Mythical_Man_Month) - A classic volume on software engineering. [Brooks's Law](#brookss-law) is a central theme of the book. +- [The Mythical Man Month - Frederick P. Brooks Jr.](https://www.goodreads.com/book/show/13629.The_Mythical_Man_Month) - A classic volume on software engineering. [Brooks's Law](#brooks-law) is a central theme of the book. - [Gödel, Escher, Bach: An Eternal Golden Braid - Douglas R. Hofstadter.](https://www.goodreads.com/book/show/24113.G_del_Escher_Bach) - This book is difficult to classify. [Hofstadter's Law](#hofstadters-law) is from the book. ## TODO From 85076029352621a2a1cd0e3ecb938eb0c32280c2 Mon Sep 17 00:00:00 2001 From: Matthias Zeis Date: Sun, 2 Jun 2019 15:04:21 +0200 Subject: [PATCH 13/37] Fix more links to Brooks' Law --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index adea7d8..eec17e6 100644 --- a/README.md +++ b/README.md @@ -73,7 +73,7 @@ As [Moore's Law](#moores-law) slows, and the acceleration of individual processo See also: -- [Brooks' Law](#brookss-law) +- [Brooks' Law](#brooks-law) - [Moore's Law](#moores-law) ### Brooks' Law @@ -451,7 +451,7 @@ See also: If you have found these concepts interesting, you may enjoy the following books. -- [The Mythical Man Month - Frederick P. Brooks Jr.](https://www.goodreads.com/book/show/13629.The_Mythical_Man_Month) - A classic volume on software engineering. [Brooks's Law](#brooks-law) is a central theme of the book. +- [The Mythical Man Month - Frederick P. Brooks Jr.](https://www.goodreads.com/book/show/13629.The_Mythical_Man_Month) - A classic volume on software engineering. [Brooks' Law](#brooks-law) is a central theme of the book. - [Gödel, Escher, Bach: An Eternal Golden Braid - Douglas R. Hofstadter.](https://www.goodreads.com/book/show/24113.G_del_Escher_Bach) - This book is difficult to classify. [Hofstadter's Law](#hofstadters-law) is from the book. ## TODO From e4aa6ec6dddf03cd241713c9347f84bc1f59de86 Mon Sep 17 00:00:00 2001 From: Alena Batitskaya Date: Wed, 5 Jun 2019 04:54:13 +0300 Subject: [PATCH 14/37] The link to Russian version added --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index eec17e6..9f105ec 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. - 🇨🇳 [中文 / Chinese Version](https://github.com/nusr/hacker-laws-zh) - thanks [Steve Xu](https://github.com/nusr)! - 🇰🇷 [한국어 / Korean Version](https://github.com/codeanddonuts/hacker-laws-kr) - thanks [Doughnut](https://github.com/codeanddonuts)! +— 🇷🇺 [Русская версия / Russian Version](https://github.com/solarrust/hacker-laws) - thanks [Alena Batitskaya](https://github.com/solarrust)! --- From 5d5f3a5748a3600dfc8ff2c3f7f821adf736b9c5 Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Thu, 6 Jun 2019 20:51:36 -0400 Subject: [PATCH 15/37] chore: indentation --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9f105ec..c97adf4 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. - 🇨🇳 [中文 / Chinese Version](https://github.com/nusr/hacker-laws-zh) - thanks [Steve Xu](https://github.com/nusr)! - 🇰🇷 [한국어 / Korean Version](https://github.com/codeanddonuts/hacker-laws-kr) - thanks [Doughnut](https://github.com/codeanddonuts)! -— 🇷🇺 [Русская версия / Russian Version](https://github.com/solarrust/hacker-laws) - thanks [Alena Batitskaya](https://github.com/solarrust)! +- 🇷🇺 [Русская версия / Russian Version](https://github.com/solarrust/hacker-laws) - thanks [Alena Batitskaya](https://github.com/solarrust)! --- From 065188a4e10f674c2bfbb6b1504b8970a570970c Mon Sep 17 00:00:00 2001 From: Pavel Date: Fri, 7 Jun 2019 17:00:10 +0300 Subject: [PATCH 16/37] Fixed link name due consistency support. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c97adf4..ed9c4ec 100644 --- a/README.md +++ b/README.md @@ -415,7 +415,7 @@ See also: ### The Dependency Inversion Principle -[The Dependency Inversion Principle](https://en.wikipedia.org/wiki/Dependency_inversion_principle) +[The Dependency Inversion Principle on Wikipedia](https://en.wikipedia.org/wiki/Dependency_inversion_principle) > High-level modules should not be dependent on low-level implementations. From 4f11a2b05179fed09f1d3669ac106077ea195675 Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Tue, 11 Jun 2019 16:17:45 +0800 Subject: [PATCH 17/37] docs: link to turkish version Closes #122. --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index ed9c4ec..eee3ba2 100644 --- a/README.md +++ b/README.md @@ -5,6 +5,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. - 🇨🇳 [中文 / Chinese Version](https://github.com/nusr/hacker-laws-zh) - thanks [Steve Xu](https://github.com/nusr)! - 🇰🇷 [한국어 / Korean Version](https://github.com/codeanddonuts/hacker-laws-kr) - thanks [Doughnut](https://github.com/codeanddonuts)! - 🇷🇺 [Русская версия / Russian Version](https://github.com/solarrust/hacker-laws) - thanks [Alena Batitskaya](https://github.com/solarrust)! +- 🇹🇷 [Türkçe / Turkish Version](https://github.com/umutphp/hacker-laws-tr) - thanks [Umut Işık](https://github.com/umutphp) --- From 6a7b48161af6e1062a028aa03fa572c00b6f042d Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Tue, 11 Jun 2019 21:23:37 +0800 Subject: [PATCH 18/37] docs: yagni formatting --- README.md | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 88fbf6c..af4d048 100644 --- a/README.md +++ b/README.md @@ -451,22 +451,28 @@ See also: ### YAGNI +[YAGNI on Wikipedia](https://en.wikipedia.org/wiki/You_aren%27t_gonna_need_it) + This is an acronym for _**Y**ou **A**ren't **G**onna **N**eed **I**t_ -> "Always implement things when you actually need them, never when you just foresee that you need them." - _[Ron Jeffries](https://twitter.com/RonJeffries) (XP co-founder and author of the book "Extreme Programming Installed")_ +> Always implement things when you actually need them, never when you just foresee that you need them. +> +> ([Ron Jeffries](https://twitter.com/RonJeffries)) (XP co-founder and author of the book "Extreme Programming Installed") -This Extreme Programming (XP) principle tells developers that they should only implement functionality that is required for the immediate present and avoid attempts to predict the future by implementing functionality that won't be used immediately, rather implement it only when deemed necessary. +This _Extreme Programming_ (XP) principle suggests developers should only implement functionality that is needed for the immediate requirements, and avoid attempts to predict the future by implementing functionality that might be needed later. -Some of the issues a developer can be faced with in a project that does not respect this principle are: -* Unnecessary increase of the overall codebase size with unused code; -* Time and productivity wasted on functionality that brings no value +Adhering to this principle should reduce the amount of unused code in the codebase, and avoid time and effort being wasted on functionality that brings no value. + +See also: + +- [Reading List: Extreme Programming Installed](#reading-list) -_[Check YAGNI article on Wikipedia](https://en.wikipedia.org/wiki/You_aren%27t_gonna_need_it)_ ## Reading List If you have found these concepts interesting, you may enjoy the following books. +- [Extreme Programming Installed - Ron Jeffries, Ann Anderson, Chet Hendrikson](https://www.goodreads.com/en/book/show/67834) - Covers the core principles of Extreme Programming. - [The Mythical Man Month - Frederick P. Brooks Jr.](https://www.goodreads.com/book/show/13629.The_Mythical_Man_Month) - A classic volume on software engineering. [Brooks' Law](#brooks-law) is a central theme of the book. - [Gödel, Escher, Bach: An Eternal Golden Braid - Douglas R. Hofstadter.](https://www.goodreads.com/book/show/24113.G_del_Escher_Bach) - This book is difficult to classify. [Hofstadter's Law](#hofstadters-law) is from the book. From e971cdee3f67e259c048ffb76c3a5be5451b8726 Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Tue, 11 Jun 2019 21:54:38 +0800 Subject: [PATCH 19/37] chore: added full-stop --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index af4d048..29b740a 100644 --- a/README.md +++ b/README.md @@ -453,7 +453,7 @@ See also: [YAGNI on Wikipedia](https://en.wikipedia.org/wiki/You_aren%27t_gonna_need_it) -This is an acronym for _**Y**ou **A**ren't **G**onna **N**eed **I**t_ +This is an acronym for _**Y**ou **A**ren't **G**onna **N**eed **I**t_. > Always implement things when you actually need them, never when you just foresee that you need them. > From ad027689c471febe25fa49f0ed3139c347fa0041 Mon Sep 17 00:00:00 2001 From: Julio Lozovei Date: Thu, 13 Jun 2019 15:17:43 -0300 Subject: [PATCH 20/37] add murphy's law --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index fb0faa8..20ac243 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [The Unix Philosophy](#the-unix-philosophy) * [The Spotify Model](#the-spotify-model) * [Wadler's Law](#wadlers-law) + * [Murphy's Law](#murphys-law) * [Principles](#principles) * [The Robustness Principle (Postel's Law)](#the-robustness-principle-postels-law) * [SOLID](#solid) @@ -279,6 +280,17 @@ See also: - [The Law of Triviality](#the-law-of-triviality) +### Murphy's Law + +[Murphy's Law on Wikipedia](https://en.wikipedia.org/wiki/Murphy%27s_law) + +> Anything that can go wrong will go wrong. + +Related to [Edward A. Murphy, Jr](https://en.wikipedia.org/wiki/Edward_A._Murphy_Jr.), the _Murphy's Law_ states that if a thing can go wrong, it'll go wrong. + +Even though it's a funny joke among developers, sometimes things go crazy when developing, testing or even when in production. + + ## Principles Principles are generally more likely to be guidelines relating to design. From 03c972192444ad4b7a3b4bf9ffaac891806a9608 Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Mon, 17 Jun 2019 15:04:30 +0800 Subject: [PATCH 21/37] chore: minor tweaks to wording --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a71eb05..955acdc 100644 --- a/README.md +++ b/README.md @@ -203,11 +203,11 @@ See also: ### Premature Optimization Effect -[Source](http://wiki.c2.com/?PrematureOptimization) +[Premature Optimization on WikiWikiWeb](http://wiki.c2.com/?PrematureOptimization) > Premature optimization is the root of all evil. > -> Donald Knuth +> [(Donald Knuth)](https://twitter.com/realdonaldknuth?lang=en) In Donald Knuth's paper [Structured Programming With Go To Statements](http://wiki.c2.com/?StructuredProgrammingWithGoToStatements), he wrote: "Programmers waste enormous amounts of time thinking about, or worrying about, the speed of noncritical parts of their programs, and these attempts at efficiency actually have a strong negative impact when debugging and maintenance are considered. We should forget about small efficiencies, say about 97% of the time: **premature optimization is the root of all evil**. Yet we should not pass up our opportunities in that critical 3%." From b01e90206267ab8af7c6110bccc59ca7e1d4d310 Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Mon, 17 Jun 2019 15:30:06 +0800 Subject: [PATCH 22/37] chore: add link to joel's profile --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 955acdc..6139033 100644 --- a/README.md +++ b/README.md @@ -249,7 +249,7 @@ One interesting element to this law is the suggestion that even by simplifying t > All non-trivial abstractions, to some degree, are leaky. > -> (Joel Spolsky) +> [(Joel Spolsky)](https://twitter.com/spolsky) This law states that abstractions, which are generally used in computing to simplify working with complicated systems, will in certain situations 'leak' elements of the underlying system, this making the abstraction behave in an unexpected way. From 83f0cd26bd356ac0cedb8cb4ec2c29faf250cd06 Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Mon, 17 Jun 2019 15:37:58 +0800 Subject: [PATCH 23/37] chore: cleanup twitter handle --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6139033..c34854a 100644 --- a/README.md +++ b/README.md @@ -249,7 +249,7 @@ One interesting element to this law is the suggestion that even by simplifying t > All non-trivial abstractions, to some degree, are leaky. > -> [(Joel Spolsky)](https://twitter.com/spolsky) +> ([Joel Spolsky](https://twitter.com/spolsky)) This law states that abstractions, which are generally used in computing to simplify working with complicated systems, will in certain situations 'leak' elements of the underlying system, this making the abstraction behave in an unexpected way. From 5760b899aad370859031eb7fcd32152e81ff31c9 Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Fri, 28 Jun 2019 11:39:47 +0800 Subject: [PATCH 24/37] chore: fix table of contents --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 19839ad..d9f352b 100644 --- a/README.md +++ b/README.md @@ -19,6 +19,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [Dunbar's Number](#dunbars-number) * [Hanlon's Razor](#hanlons-razor) * [Hofstadter's Law](#hofstadters-law) + * [Hutber's Law](#hutbers-law) * [The Hype Cycle & Amara's Law](#the-hype-cycle--amaras-law) * [Hyrum's Law (The Law of Implicit Interfaces)](#hyrums-law-the-law-of-implicit-interfaces) * [Moore's Law](#moores-law) @@ -153,7 +154,7 @@ See also: > > ([Patrick Hutber](https://en.wikipedia.org/wiki/Patrick_Hutber)) -This law suggests that improvements to a system will lead to deterioration in other parts, or it will hide other deterioration, leading overall to a degredation from the current state of the system. +This law suggests that improvements to a system will lead to deterioration in other parts, or it will hide other deterioration, leading overall to a degradation from the current state of the system. For example, a decrease in response latency for a particular end-point could cause increased throughput and capacity issues further along in a request flow, effecting an entirely different sub-system. From ce06e772d76eb5291bcd8ca26081499acfdd3637 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Umut=20I=C5=9F=C4=B1k?= Date: Fri, 28 Jun 2019 16:20:47 +0300 Subject: [PATCH 25/37] Translate tr.md via GitLocalize --- translations/tr.md | 505 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 505 insertions(+) create mode 100644 translations/tr.md diff --git a/translations/tr.md b/translations/tr.md new file mode 100644 index 0000000..b856faa --- /dev/null +++ b/translations/tr.md @@ -0,0 +1,505 @@ +# 💻📖 hacker-laws + +Programcıların faydalı bulacağı yasalar, teoriler, prensipler ve desenler. + +- 🇨🇳 [中文 / Çince İçin](https://github.com/nusr/hacker-laws-zh) - Teşekkürler [Steve Xu](https://github.com/nusr)! +- 🇰🇷 [한국어 / Korece İçin](https://github.com/codeanddonuts/hacker-laws-kr) - Teşekkürler [Doughnut](https://github.com/codeanddonuts)! +- 🇷🇺 [Русская версия / Rusça İçin](https://github.com/solarrust/hacker-laws) - Teşekkürler [Alena Batitskaya](https://github.com/solarrust)! +- 🇹🇷 [Türkçe / Turkçe İçin](https://github.com/umutphp/hacker-laws-tr) - Teşekkürler [Umut Işık](https://github.com/umutphp) + +--- + + + +- [Giriş](#introduction) +- [Yasalar](#laws) + - [Amdahl Yasası](#amdahls-law) + - [Brooks' Law](#brooks-law) + - [Conway Yasası](#conways-law) + - [Dunbar Sayısı](#dunbars-number) + - [Hanlon'un Usturası](#hanlons-razor) + - [Hofstadter Yasası](#hofstadters-law) + - [Hutber Yasası](#hutbers-law) + - [Hype Döngüsü ve Amara Yasası](#the-hype-cycle--amaras-law) + - [Hyrum Yasası (Arabirimlerin Örtülü Hukuku)](#hyrums-law-the-law-of-implicit-interfaces) + - [Moore Yasası](#moores-law) + - [Parkinson Yasası](#parkinsons-law) + - [Olgunlaşmamış Optimizasyon Etkisi](#premature-optimization-effect) + - [Putt Yasası](#putts-law) + - [Karmaşıklığın Korunması Yasası (Tesler Yasası)](#the-law-of-conservation-of-complexity-teslers-law) + - [The Law of Leaky Abstractions](#the-law-of-leaky-abstractions) + - [Önemsizlik Yasası](#the-law-of-triviality) + - [Unix Felsefesi](#the-unix-philosophy) + - [Spotify Modeli](#the-spotify-model) + - [Wadler Yasası](#wadlers-law) +- [Prensipler](#principles) + - [Pareto Prensibi (80/20 Kuralı)](#the-pareto-principle-the-8020-rule) + - [Dayanıklılık Prensibi (Postel Yasası)](#the-robustness-principle-postels-law) + - [SOLID](#solid) + - [Tek Sorumluluk Prensibi](#the-single-responsibility-principle) + - [Açık/Kapalı Prensibi](#the-openclosed-principle) + - [Liskov Yerine Geçme Prensibi](#the-liskov-substitution-principle) + - [Arayüz Ayrım Prensibi](#the-interface-segregation-principle) + - [Bağımlılığın Ters Çevrilmesi](#the-dependency-inversion-principle) + - [DRY Prensibi](#the-dry-principle) + - [YAGNI](#yagni) +- [Ek Kaynaklar](#reading-list) +- [TODO](#todo) + + + +## Giriş + +İnsanların geliştirme hakkında konuşurken tartıştıkları birçok yasa var. Bu depo, en yaygın olanlardan bazılarının referanslarını ve özetini barındırır. Katkıda bulunmak için PR açıp gönderebilirsiniz! + +❗: Bu depo yasaların, prensiplerin ve modellerin bilgi vermek amaçlı açıklamalarını içerir ve hiçbirini *savunma* amacı gütmez. Bunların hangisinin uygulanıp uygulanmayacağı tamamen tartışma konusudur ve yapılan işe bağlıdır.. + +## Yasalar + +Tek tek başlayalım! + +### Amdahl Yasası + +[Wikipedia Amdahl Yasası](https://en.wikipedia.org/wiki/Amdahl%27s_law) + +> Amdahl Yasası kaynakları artırarak bir hesaplama işleminin *olası* hızlanma miktarını hesaplayan bir formülü tanımlar. Genellikle paralel işleme hesaplarında kullanılır ve işlemci sayısının artırılmasının programın paralelleştirilebilme kapasitesine bağlı olarak etkisinin doğru şekilde saplanmasını sağlar. + +En güzel şu örnekle anlatılabilir. Bir programın iki bölümden oluştuğunu düşünelim. Bölüm A sadece tek işlemci ile çalıştırılabilir. Bölüm B ise paralelleştirilebilecek şekilde yazılmış. Bu durumda bu programı çok işlemci ile çalıştırdığımızda Bölüm B'de oluşacak kadar bir kazanım sağlayabiliriz. Bölüm A'da her hangi bir katkı olamayacaktır. + +Aşağıdaki diyagram bazı olası hız geliştirmelerine örnekler içeriyor: + +![Diagram: Amdahl's Law](../images/amdahls_law.png) + +*(Diyagramın kaynağı: Daniels220 tarafından İngilizce Wikipedia'da, Creative Commons Attribution-Share Alike 3.0 Unported, https://en.wikipedia.org/wiki/File:AmdahlsLaw.svg)* + +Diyagramdaki örneklerden görüldüğü üzere, eğer bir programın sadece %50'si paralelleştirilebiliyorsa 10 işlemciden sonra işlemci eklemek hızda gözle görünür bir artış sağlamıyor ama %95 paralelleştirilebilen bir programda 1000 işlemciden sonra bile işlemci eklemenin hızı artırdığı gözlenebilir. + +[Moore Yasasında](#moores-law) söylenen artışın azalma eğiliminde olması ve aynı zamanda işlemci hızının artışında da ivme kaybı olması, paralelleştirilebilme özelliğini performans artışında anahtar duruma getirdi. Grafik programlama bu konuda en belirgin örnek. Shader tabanlı modern işleme ile pixel ve fragmanların paralel olarak render edilebilmesi sayesinde modern grafik kartlarında binlerce işlemci çekirdeği olabiliyor. + +Ek kaynaklar: + +- [Brooks Yasası](#brooks-law) +- [Moore Yasası ](#moores-law) + +### Brooks Yasası + +[Wikipedia'da Brooks Yasası](https://en.m.wikipedia.org/wiki/Brooks%27s_law) + +> Gecikmesi kesinleşmiş projeye yeni insan kaynağı eklemek projeyi daha da geciktirir. + +Bu yasa, gecikmiş bir projeyi hızlandırmak için ek insan kaynağı koymanın projeyi daha geciktireceğini iddia ediyor. Brook'a göre bunun gereksiz bir sadeleştirme olduğu kesin. Yeni katılanların adapte edilmesi ve iletişim karmaşası hemen etkisini göstererek hızın yavaşlamasına sebep olur. Ayrıca, yapılacak işlerin birçoğu genellikle daha küçük parçalara bölünemez ve birden fazla kaynak bu işlerin yapılması için kullanılmaz. Bu durum beklenen artışın sağlanmaması ile sonuçlanır. + +Meşhur "Dokuz kadın ile 1 ayda doğum sağlanamaz" deyimi bu yasanın en pratik anlatımıdır. Bazı işlerin bölünemediği veya paralelleştirilemediği gerçeğini unutmamak lazım. + +'[The Mythical Man Month](#reading-list)' adlı kitabın ana konularından biri budur. + +Ek kaynaklar: + +- [Death March](#todo) +- [Reading List: The Mythical Man Month](#reading-list) + +### Conway Yasası + +[Wikipedia'da Conway Yasası](https://en.wikipedia.org/wiki/Conway%27s_law) + +Conway yasası der ki; üretilen sistemler kendilerini üreten organizasyonun teknik sınırlarını yansıtır. Bu yasa daha çok organizasyon değişiklikleri sırasında dikkate alınır. Eğer bir organizasyon birbirinden bağımsız küçük birimlerden oluşuyorsa üretilen yazılımlar da buna uygun olacaktır. Eğer bu organizasyon servis odaklı dikey yapılandırılmışsa, yazılımlar bunu yansıtacaktır. + +Ek kaynaklar: + +- [Spotify Modeli](#the-spotify-model) + +### Dunbar Sayısı + +[Wikipedia'da Dunbar Sayısı](https://en.wikipedia.org/wiki/Dunbar%27s_number) + +"Dunbar'ın sayısı, bir kişinin istikrarlı bir sosyal ilişkide bulunabileceği kişilerin sayısının kavramsal sınırıdır - bu ilişki bireyin ilişkide olduğu her bir kişinin kim olduğunu ve her bir kişinin diğer bir kişiler ile ilişkisini bildiği ilişkidir." Sayının tam değeri konusunda bir anlaşmazlık vardır. "... [Dunbar] insanların ancak 150 kişilik ilişkiler istikrarlı bir şekilde bulunabileceğini söylemiş."... Dunbar sayıyı daha sosyal bir bağlam içine koydu, "sayıyı bir barda içki içmeye davet edildiğinizde sıkılmadan ya da utanmadan kabul edebileceğiniz kişi sayısı olarak değerlendirdi". Bu da 100 ile 250 arasındaki bir sayı olarak düşünülebilir. + +Kişiler arası insani ilişkilerde olduğu gibi, insanlarla kod arasındaki ilişki de sürüdürülebilmek için çaba gerektirir. Karmaşık projelerle karşılaştığımızda ya da bu projeleri yönetmek sorunda kaldığımızda, projeyi ölçekleyebilmek için eğilimlere, politikalara ve modellenmiş prosedürlere yaslanmaya çalışırız. Dunbar sayısını sadece çalışan sayısı büyüdüğünde değil, takımın harcayacağı emeğin kapsamını belirlerken ya da sistemdeki lojistik ek yükün modellenmesine ve otomatikleştirilmesine yardımcı olmak için takımlara yatırım yaparken de göz önünde bulundurulmalıdır. Bir başka mühendislik bağlamında düşünürsek, bu sayı müşteri destek sisteminde nöbetçi olunurken sorumluluğunu alabileceğiniz proje/ürün sayısını belirlerken de rehber olabilir. + +Ek kaynaklar: + +- [Conway Yasası](#conways-law) + +### Hanlon'un Usturası + +[Wikipedia'da Hanlon'un Usturası](https://en.wikipedia.org/wiki/Hanlon%27s_razor) + +> Aptallıkla layıkıyla açıklanabilecek bir şeyi, asla kötü niyete bağlamayın. +> Robert J. Hanlon + +Bu prensip, olumsuz sonuçlara yol açan eylemlerin, çoğunlukla kötü niyetin sonucu olmadığını savunmaktadır. Aksine, olumsuz sonuç daha büyük olasılıkla bu eylemlerin ve/veya etkinin tam olarak anlaşılamamasına bağlıdır. + +### Hofstadter Yasası + +[Wikipedia'da Hofstadter Yasası](https://en.wikipedia.org/wiki/Hofstadter%27s_law) + +> Bir iş her zaman umduğundan daha uzun sürer, Hofstadter yasasını göz önünde bulundursan bile. +> (Douglas Hofstadter) + +Bu yasayı bir işin ne kadar süreceğini tahminlenirken hatırlatıldığı için duymuş olabilirsiniz. Herkesin kabul bir gerçek var ki, yazılım geliştirmede en kötü olduğumuz alan işin ne kadar sürede biteceğini tahmin etmektir. + +'[Gödel, Escher, Bach: An Eternal Golden Braid](#reading-list)' adlı kitaptan bir alıntı. + +Ek kaynaklar: + +- [Reading List: Gödel, Escher, Bach: An Eternal Golden Braid](#reading-list) + +### Hutber Yasası + +[Wikipedia'da Hutber Yasası ](https://en.wikipedia.org/wiki/Hutber%27s_law) + +> İyileştirme, bozulma anlamına da gelir. +> ([Patrick Hutber](https://en.wikipedia.org/wiki/Patrick_Hutber)) + +Bu yasa der ki; sistemde yapılan bir iyileştirme sistemin diğer taraflarında bozulmaya sebep olabilir ya da başka bozuklukları gizleyebilir, bu da sistemin mevcut durumunun daha da bozulmasına sebep olabilir. + +Örneğin, bir servisin cevap verme zamanında bir geliştirme yapılıp hızlandırılırsa bu durum süreçteki diğer aşamalarda kapasite ve çıktı artışına sebep olabilir. Bu da sistemin diğer taraflarını olumsuz etkileyebilir. + +### Hype Döngüsü ve Amara Yasası + +[Wikipedia'da Hype Döngüsü](https://en.wikipedia.org/wiki/Hype_cycle) + +> Bir teknolojinin kısa vadede oluşacak etkisini abartıp, uzun vadede oluşacak etkisini hafife alıyoruz. +> (Roy Amara) + +Hype Döngüsü bir teknolojinin zamanla yarattığı heyecan ve gelişiminin görsel olarak sunumudur ve Gartner tarafından ilk olarak oluşturulmuştur. En güzel anlatım aşağıdaki bir görsel ile yapılabilir: + +![The Hype Cycle](../images/gartner_hype_cycle.png) + +*(Resmin Kaynağı: Jeremykemp tarafından İngilizce Wikipeda'da, CC BY-SA 3.0, https://commons.wikimedia.org/w/index.php?curid=10547051)* + +Kısaca anlatmak gerekirse, bu döngü her yeni teknolojinin ilk zamanlarında teknolojinin kendisi ve olası etkisi üzerinde bir heyecan dalgası oluştuğunu iddia ediyor. Ekipler yeni teknolojiler hemen kullanmaya çalışıyorlar ve genelde kendilerini sonuçtan memnun olmamış bir halde buluyorlar. Bu ya teknolojinin henüz olgunlaşmamış olmasından, ya da uygulamanın tam anlamıyla gerçekleşmemiş olmasından olabilir. Belirli bir süre geçtikten sonra, teknolojinin yeterliliği ve pratik kullanım alanları artar ve ekipler daha üretken olmaya başlar. Roy Amara'nın sözü bu durumu en özlü şekilde toparlıyor diyebiliriz - "Bir teknolojinin kısa vadede oluşacak etkisini abartıp, uzun vadede oluşacak etkisini hafife alıyoruz". + +### Hyrum Yasası (Arabirimlerin Örtülü Hukuku) + +[Hyrum Yasası Web Sitesi](http://www.hyrumslaw.com/) + +> Belli sayıda kullanıcıya ulaştığında, servis sözleşmesinde ne demiş olduğunuzdan bağımsız olarak ürününüzün ya da sisteminizin bütün gözlemlenebilir davranışları artık üçüncü kişilere göre şekillenecektir. +> (Hyrum Wright) + +Hyrum Yasası göre, eğer bir API'nin *oldukça büyük sayılabilecek sayıda kullanıcısı* olduğunda, artık bütün sonuçlar ve davranışlar (API sözleşmesinde belirtilmemiş olsalar bile) kullanıcılara göre şekillenecektir. Buna bir örnek olarak bir API'nin tepki süresi olabilir. Daha kapsamlı bir örnek olarak kullanıcıların bir regex ile dönen cevap metninin içinden hatanın *tipini* ayıkladıkları bir senaryoyu düşünelim. API sözleşmesinde bu cevap metinleri ile ilgili bir şey belirtilmemiş olmasına ve kullanıcıların hata kodunu kullanmalarını belirtilmesine rağmen, cevap metnini değiştirmeniz *bazı* kullanıcıların metni kullanmalarından dolayı hata ile karşılaşmalarına sebep olacaktır. + +Ek kaynaklar: + +- [The Law of Leaky Abstractions](#the-law-of-leaky-abstractions) +- [XKCD 1172](https://xkcd.com/1172/) + +### Moore Yasası + +[Wikipedia'da Moore Yasası](https://en.wikipedia.org/wiki/Moore%27s_law) + +> Entegre devre içerisindeki transistörlerin sayısı yaklaşık olarak iki yılda bir ikiye katlanır. + +Çoğu zaman yarı-iletken ve çip teknolojisinin gelişim hızını tahmin etmek için kullanılan Moore yasasının, 1970'lerden 2000'lerin sonlarına doğru oldukça doğru olduğu biliyoruz. Son yıllarda, [komponentlerin küçülmesinde fiziksel sınırlara](https://en.wikipedia.org/wiki/Quantum_tunnelling) ulaşıldığı için bu tahminlemenin tutmadığını da söyleyebiliriz. Ama paralelleştirmede uzmanlaşılması ve yarı-iletken teknolojilerindeki devrim potansiyelindeki değişiklikler Moore Yasası'nın yakın zamanda tekrar doğrulanacağını tahminler yapabileceğini düşünebiliriz. + +### Parkinson Yasası + +[Wikipedia'da Parkinson Yasası](https://en.wikipedia.org/wiki/Parkinson%27s_law) + +> Bir iş, daima, bitirilmesi için kendisine ayrılan sürenin hepsini kapsayacak şekilde uzar. + +Orijinal bağlamında, bu kanun bürokrasi alanındaki çalışmalara dayanıyordu. Kötümser bir bakış açısıyla yazılım geliştirme girişimleri için de söylenebilir. Şöyle ki ekipler genelde proje bitiş tarihi yaklaşana kadar düşük verimde çalışırlar, bitiş tarihi yaklaştıkça bitirmek için yoğun bir çaba içine girerler ve sonuç olarak aslında bitiş tarihini tutturmuş olurlar. + +Bu yasa ile [Hofstadter Yasası](#hofstadters-law) birleştirilirse, daha kötümser bir yasaya ulaşılır. Bir iş bitirilmesi için harcanması gereken zamanı kapsar ve *her zaman gecikir*. + +Ek kaynaklar: + +- [Hofstadter's Law](#hofstadters-law) + +### Olgunlaşmamış Optimizasyon Etkisi + +[WikiWikiWeb'de Olgunlaşmamış Optimizasyon Etkisi](http://wiki.c2.com/?PrematureOptimization) + +> Vakti gelmeden gelmeden yapılan optimizasyon bütün kötülüklerin anasıdır. +> [(Donald Knuth)](https://twitter.com/realdonaldknuth?lang=en) + +Donald Knuth yazdığı [Structured Programming With Go To Statements](http://wiki.c2.com/?StructuredProgrammingWithGoToStatements) isimli makalede, "Programcılar, programlarının kritik olmayan bölümlerinin hızını düşünerek veya endişelenerek çok fazla zaman harcarlar ve bu bakış açısı ile yaptıkları verimlilik geliştirmelerin hata ayıklama ve bakım yapma aşamalarına çok olumsuz etkileri olur. Kesinlikle bu tarz küçük geliştirmeleri (zamanımızın %97'sini harcadığımız) göz ardı etmeliyiz, **Vakti gelmeden yapılan optimizasyon bütün kötülüklerin anasıdır** gerçeğini unutmamalılıyız. Yine de, geride kalan % 3'teki kritik fırsatları kaçırmamalıyız." + +Aslında, *olgunlaşmamış optimizasyonu* ihtiyacımızın ne olduğunu bilmeden yapılan optimizasyon olarak tanımlayabiliriz (daha basit kelimelerle). + +### Putt Yasası + +[Wikipedia'da Putt Yasası](https://en.wikipedia.org/wiki/Putt%27s_Law_and_the_Successful_Technocrat) + +> Teknolojide iki tür insan egemendir, yönetmedikleri şeyleri anlayanlar ve anlamadıkları şeyleri yönetenler. + +Putt yasasını çoğunlukla Putt sonucu takip eder: + +> Her teknik hiyerarşi, zaman içinde bir yetkinlik dönüşümü geliştirir. + +Bu iki cümle, ekiplerin oluşturulmasında rol alan farklı seçim kriterleri ve eğilimlerden dolayı, bir organizasyonda çalışma katmanlarında çok sayıda yetenekli insan olduğu gibi yönetim katmanlarında da yapılan işin karmaşıklığından ve zorluklarından haberdar olmayan yöneticiler olacaktır. Bunun sebebi [Peter Prensibi](#TODO) or [Dilbert Yasası](#TODO) gibi olgular olabilir. + +Bununla birlikte, bunun gibi yasaların çok büyük genellemeler olduğu ve *bazı* organizasyon türleri için geçerli olabileceği gibi başkaları için geçerli olmayacağı unutulmamalıdır. + +Ek kaynaklar: + +- [Peter Prensibi](#TODO) +- [Dilbert Yasası](#TODO). + +### Karmaşıklığın Korunması Yasası (Tesler Yasası) + +[Wikipedia'da Karmaşıklığın Korunması Yasası](https://en.wikipedia.org/wiki/Law_of_conservation_of_complexity) + +Bu yasa der ki, her sistemde kesinlikle ayıklanamayacak bir miktarda karmaşıklık vardır. + +Bir sistem ve yazılımdaki karmaşıklıkların bazıları dikkatsizlik veya yanlışlıktan ortaya çıkar. Bu kötü kurgulanmış yapının, herhangi bir dikkatsizliğin, ya da problemin kötü modellenmesinin sonucu olabilir. Bu tarz karmaşıklıklar giderilebilir ve sistemden ayıklanabilir. Bunun yanında, bazı karmaşıklıklar sistemin gerçekleridir yani sistemin çözmeye çalıştığı problemin doğası gereği ortaya çıkarlar. Bu tarz karmaşıklıklar sistem içinde farklı yerlere taşınabilirler ama sistemden ayıklanmazlar. + +O yasanın farklı bir yansıması olarak şöyle düşünülebilir, eğer bir karmaşıklık esastan geliyorsa ve sistem sadeleştirilerek bile ayıklanamıyorsa, daha karmaşık bir şekilde davranması beklenen *kullanıcının tarafına taşınabilir*. + +### Sızdıran Soyutlamalar Yasası + +[Sızdıran Soyutlamalar Yasası, Joel on Software](https://www.joelonsoftware.com/2002/11/11/the-law-of-leaky-abstractions/) + +> Önemsiz sayılmayacak bütün soyutlamar belli ölçüde sızıntı içerir. +> ([Joel Spolsky](https://twitter.com/spolsky)) + +Bu yasa, karmaşık sistemleri sadeleştirmek için kullandığımız soyutlamaların bazı durumlarda soyutlamanın altındaki sistemin öğelerini sorunları ile birlikte sızdırır ve bu da beklenmedik davranışlar ortaya çıkması ile sonuçlanır. + +Dosya açma ve okuma işlemlerini örneklemek için kullanabiliriz. Dosya sistemi arayüzleri altta yeralan çekirdek sistemlerinin bir *soyutlamasıdır*, ki çekirdek sistemleri de aslında manyetik plakalardaki (fash disk ya da SDD) veriyi fiziksel olarak değiştiren işlemlerin soyutlamasıdır. Çoğu durumda, bir dosyayı ikili sistemdeki verilerin akışı olarak soyutlamak işe yarar. Manyetik sürücüler sıralı okuma yapıldığında rastgele erişimli sürücülere göre *daha* hızlıdır (sayfalama hatalarının artmasından dolayı) ama bu durum SDD sürücülerle karşılaştırmada geçerli değildir. Bu durumun üstesinden gelmek için, detayların altında yatan bilgileri (yani geliştiricinin bilmesi gereken uygulama detaylarını) soyutlamanın sızdırıyor olacağı dikkate alınmalıdır. + +Yukarıda verdiğimiz örnek *daha fazla* soyutlanma göz önünde bulundurulursa daha da karmaşıklaşabilir. Linux işletim sistemi dosyalara bir ağ üzerinden erişilmesine olanak sağlıyor ama bu dosyalar sanki yerel dosyalarmış gibi gösterilir. Bu soyutlama da eğer bir network sorunu olursa sızıntı oluşturur. Eğer bir uygulama geliştirici bu tür dosyaları normal dosyalarmış gibi düşünerek geliştirme yaparsa, ağızda oluşan herhangi bir gecikme ya da sorun çözümü sorunlu hale getirecektir. + +Yasa savunmaya çalıştığı durum, herhangi bir soyutlamaya çok fazla güvenmenin alta yatan işlemleri de tam anlamamayla birleşince çözülmeye çalışılan problemin çoğunlukla *daha da* karmaşıklaşması ile sonuçlanacağıdır. + +Ek kaynaklar: + +- [Hyrum Yasası](#hyrums-law-the-law-of-implicit-interfaces) + +Real-world examples: + +- [Photoshop'taki yavaş açılma problemi](https://forums.adobe.com/thread/376152): Photoshop bir zamanlar çok yavaş açılırdı, hatta bazen açılması dakikalar sürerdi. Sorunun sebebi program her başlangıçta ön tanımlı yazıcı ile ilgili belli bilgileri çekmeye çalışması olarak gözüküyordu. Eğer yazıcı bir ağ yazıcısıysa açılma daha da uzun sürüyordu. Ağ yazıcılarının yerel yazıcıları gibi *soyutlanması* kullanıcılara bu kötü deneyimi yaşatmış oldu. + +### Önemsizlik Yasası + +[Wikipedia'da Önemsizlik Yasası](https://en.wikipedia.org/wiki/Law_of_triviality) + +Bu yasa diyor ki, ekipler önemsiz ve kozmetik sorunlara ciddi ve önemli sorunlara göre daha fazla zaman harcarlar. + +En çok kullanılan kurgu örnek nükleer enerji reaktörünü onaylayacak olan komitenin reaktörün genel tasarımını onaylama zamanından çok bisiklet parkının tasarımını onaylamak için zaman harcamasıdır. Çok büyük ve karmaşık konularla ilgili o alanda bir eğitime, tecrübeye ve hazırlığa sahip olmadan kayda değer yorum getirmek zordur. İnsanlar genelde değerli katkılar verdiklerinin görülmesini isterler. Dolayısıyla insanlar kolayca katkı verebilecekleri gerekli ve önemli olmasa bile küçük detaylara odaklanma eğilimi gösterirler. + +Bu kurgu örnek 'Bike Shedding' diye bir deyimin yaygınlaşmasına sebep olmuştur. Türkçe'deki 'pire için yorgan yakmak' ya da 'attığın taş ürküttüğün kurbağaya değsin' gibi deyimlere benzer. + +### Unix Felsefesi + +[Wikipedia'da Unix Felsefesi](https://en.wikipedia.org/wiki/Unix_philosophy) + +Unix felsefesi şöyle özetlenebilir; bir yazılım parçası olabildiğince küçük olmalı ve sadece bir işi yapmaya odaklanmalıdır. Bu felsefeye uymak sistemleri büyük, karmaşık ve çok amaçlı programlarla oluşturmak yerine küçük, basit ve iyi tanımlanmış parçalardan daha kolayca oluşturmayı sağlar. + +Modern yaklaşımlardan biri olan 'Mikro-service Mimarisi' de bu felsefenin uygulaması olarak düşünülebilir. Çünkü bu mimari ile servislerin küçük, amaç odaklı ve tek bir iş yapacak şekilde geliştirilmesi ve karmaşık yapıların küçük basit bloklar halinde oluşturulması hedefleniyor. + +### Spotify Modeli + +[Spotify Modeli, Spotify Labs](https://labs.spotify.com/2014/03/27/spotify-engineering-culture-part-1/) + +Spotify Modeli Spotify'daki uygulamasından dolayı popüler olmuş ekip ve organizasyon yapıları için yeni bir yaklaşımdır. Model basitçe ekiplerin teknolojilere göre değil de özellikler etrafında organize edilmesidir. + +Spotify Modeli kabileler (Tribes), birlikler (Guilds) ve kısımlar (Chapter) gibi organizasyon yapısında kullanılacak öğeleri de yaygın hale getirdi. + +### Wadler Yasası + +[Wadler Yasası, wiki.haskell.org](https://wiki.haskell.org/Wadler's_Law) + +> Herhangi bir programlama dilini tasarlarken, aşağıdaki listedeki herhangi bir özelliği tartışmak için harcanan zaman iki üzeri özelliğin listeki sırası ile doğru orantılıdır. +> 1. Semantik +> 2. Genel sözdizimi +> 3. Sözcük sözdizimi +> 4. Yorumlardaki sözcük sözdizimi +> (Kısaca semantic için harcanan her bir saat için yorumlardaki sözcük sözdizimi için sekiz saat harcanacaktır.) + +[Önemsizlik Yasasında](#the-law-of-triviality) öne sürülene benzer olarak, Wadler Yasası yeni bir programlama dili tasarlanırken konunun önemi ile o konu için harcanan zaman ters orantılı olduğunu söylüyor. + +Ek kaynaklar: + +- [Önemsizlik Yasası](#the-law-of-triviality) + +## Prensipler + +Prensiplerin genellikle tasarıma ilişkin rehberlerdir. + +### Pareto Prensibi (80/20 Kuralı) + +[Wikipedia'da Pareto Prensibi](https://en.wikipedia.org/wiki/Pareto_principle) + +> Hayattaki çoğu şey eşit dağılmaz. + +Pareto Prensibi der ki, çıktıların önemli bir çoğunluğu girdilerin çok azı tarafından oluşturulur: + +- Bir yazılımın 80%'i harcanan zamanın %20'sinde yazılır (bir başka deyişle, kodun en zor %20'lik bölümü haracanan zamanın %80'inde yazılır) +- Harcanan eforun %20'si sonucun %80'ini oluşturur +- Yapılan işin %20'si gelirin %80'ini oluşturur +- Koddaki hataların %20'si sistem sorunlarının %80'ini oluşturur +- Özelliklerin %20'si hizmetin %80'ini oluşturur + +1940'lı yıllarda Romanya kökenli Amerikalı mühendis Dr. Joseph Juran, kendisi kalite kontrolün babası olarak nitelendirilir, [kalite kontrol sorunlarında Pareto Prensibini kullanmaya başladı](https://en.wikipedia.org/wiki/Joseph_M._Juran). + + +Bu prensip aynı zamanda 80/20 Kuralı (The Law of the Vital Few and The Principle of Factor Sparsity) olarak da bilinir. + +Real-world examples: + +- 2002'de Microsoft en çok rapor edilen hataların üstten %20'sini çözünce kullanıcıların yaşadığı sorunların %80'inin çözüldüğünü gözlemlemiş ([Referans](https://www.crn.com/news/security/18821726/microsofts-ceo-80-20-rule-applies-to-bugs-not-just-features.htm)). + +### Dayanıklılık Prensibi (Postel Yasası) + +[Wikipedia'da Dayanıklılık Prensibi](https://en.wikipedia.org/wiki/Robustness_principle) + +> Yaptıklarınızda muhafazakar olun, başkalarından kabul ettiğiniz şeyler konusunda liberal olun. + +Genellikle sunucu uygulamaları geliştirirken uygulanabilir. Bu prensip der ki; kendi uygulamanızdan dışarıya veri gönderirken kılı kırk yararcasına dikkatli olun ama dışardan veri alırken mümkün olabilecek her durumda veriyi kabul etmeye çalışın. + +Bu prensibin amacı dayanıklı sistemlere geliştirmektir ve bu sistemler kötü yapılandırılmış girdileri bile anlayabildikleri durumda işleyebilmeliler. Bunun güvenlik açısından kötü amaçlı ve yeterince kontrol edilmemiş girdileri kabul etmek anlamına gelebileceği için riskli olduğu düşünülebilir. Tabiki bu riskin de göz önünde bulundurulması gerekir. + +### SOLID + +SOLID aşağıdaki beş prensibin baş harflerinden oluşan bir kısaltmadır; + +- S: [Tek Sorumluluk Prensibi - The Single Responsibility Principle](#the-single-responsibility-principle) +- O: [Açık/Kapalı Prensibi - The Open/Closed Principle](#the-openclosed-principle) +- L: [Liskov Yerine Geçme Prensibi - The Liskov Substitution Principle](#the-liskov-substitution-principle) +- I: [Arayüz Ayrım Prensibi - The Interface Segregation Principle](#the-interface-segregation-principle) +- D: [Bağımlılığın Ters Çevrilmesi - The Dependency Inversion Principle](#the-dependency-inversion-principle) + +Bunları [Nesne Tabanlı Proglamlama'nın](#todo) temel prensipleri olarak değerlendirilebilir ve bu prensiplerin programcılara geliştirilebilir ve desteklenebilir sistemler geliştirmelerinde yardımcı oldukları kesindir. + + +### Tek Sorumluluk Prensibi + +[Wikipedia'da Tek Sorumluluk Prensibi](https://en.wikipedia.org/wiki/Single_responsibility_principle) + +> Her sistem parçasının ya da programlama sınıfının sadece bir sorumluluğu olmalı. + +Bu '[SOLID](#solid)' prensiplerinin ilkidir. Bu prensip der ki her bir sistem parçasının yada programlama sınıfının sadece ama sadece bir sorumluluğu olması gerekir. Daha sade anlatmak gerekirse, bir programdaki sadece bir özelliği etkileyen bir değişiklik sadece o özelliği ilgilendiren parça ya da sınıfta yapılmalı. Örneğin, şifrelerin doğruluğunun kontrolünde bir değiştirme yapılacaksa sadece programın o bölümünde değişiklik yapılmalı. + +Teorik olarak, bu prensibe uygun yazılmış kodlar daha sağlam ve değiştirilmesi kolaydır. Sadece tek bir parçanın değiştirildiğine emin olunduğunda değişimi *tesk etmek* de kolay olacaktır. Önceki şifre örneğini düşünürsek, şifrenin zorluk seviyesi değiştirildiğinde sadece şifre ilgili bölümlerin etkilenecektir. Birden fazla sorumluluğu olan bir bölümde olan değişikliğin nereleri etkileceğini hesaplamak daha zordur. + + +Ek kaynaklar: + +- [Nesne Tabanlı Programlama](#todo) +- [SOLID](#solid) + +### Açık/Kapalı Prensibi + +[Wikipedia'da Açık/Kapalı Prensibi](https://en.wikipedia.org/wiki/Open%E2%80%93closed_principle) + +> Her sistem parçası (sınıf, modül, fonksiyon vs) genişletilmeye (türev alınmaya, miras alınma vs) açık olmalı ama değiştirilmeye (modifiye etme) kapalı olmalı. + +Bu '[SOLID](#solid)' prensiplerinin ikincisidir ve herhangi bir sistem parçasının *mevcut* davranışının değiştirilememesini ama kullanılarak/türetilerek *genişletilebilmesinin* gerekliliğini savunur. + + +Örneğin Markdown formatındaki belgeleri HTML formatına çeviren bir modülü düşünelim. Eğer bu modül kendisi değiştirilmeden yeni bir Markdown formatını da işlemesi sağlanacak şekilde geliştirilebiliyorsa, bu modül genişletilmeye açık demektir. Eğer sonradan değiştirilip Markdown formatı işlemesi ile ilgili geliştirme *yapılamıyorsa*, bu modül değiştirilmeye *kapalı* demektir. + + +Bu prensip nesne-tabanlı programlamaya tam uygundur. Şöyle ki, kendi nesne ve sınıflarımızı miras alınarak geliştirmeye uygun ve değiştirmeye ihtiyaç duymayacak şekilde tasarlarsak ve yazarsak nesne-tabanlı programlamaya tam uygun kod yazmış oluruz. + +See also: + +- [Object-Oriented Programming](#todo) +- [SOLID](#solid) + +### Liskov Yerine Geçme Prensibi + +[Wikipedia'da Liskov Yerine Geçme Prensibi](https://en.wikipedia.org/wiki/Liskov_substitution_principle) + +> Bir sistemde var olan bir özellik kendinden türetilmiş türetilmiş bir özellikle herhangi bir sistemsel soruna sebep olmadan yer değiştirilebilmeli. + +'[SOLID](#solid)' prensiplerinin üçüncüsüdür. Bu prensibe göre herhangi bir bileşenin üzerine dayandığı bir özelliği (sınıf vs) o özelliklikten türetilmiş alt özellikle değiştirebilmeliyiz ve bu durumda bir sistem sorununa neden olunmaz ya da alt özelliğin bütün detaylarını bilmeye gerek kalmaz. + + +Örneğin dosyayı temsil eden bir yapıdan XML verisi okuyan bir metod düşünelim. Eğer bu metod 'dosya' tipini kullanıyorsa, 'dosya' tipinden türeyen bütün tipleri de kullanabilmelidir. Eğer 'dosya' tipi geriye dönük aramayı destekliyorsa ama 'dosya' tipinden türetilmiş 'ağ dosyası' tipi bunu desteklemiyorsa o zaman 'ağ dosyası' tipi bu prensibi ihlal ediyor demektir. + +Bu prensip nesne-tabanlı programlamanın bağlı olduğu prensiplerden biridir ve geliştiricilerin kafasını karıştırmamak için sınıf hiyerarşisinin dikkatli tarasarlanması gerektiğini söyler. + +Ek kaynaklar: + +- [Nesne Tabanlı Programlama](#todo) +- [SOLID](#solid) + +### Arayüz Ayrım Prensibi + +[Wikipedia'da Arayüz Ayrım Prensibi](https://en.wikipedia.org/wiki/Interface_segregation_principle) + +> Hiçbir kullanıcı/müşteri/istemci, kullanmadığı yöntemlere bağlı kalmamalıdır. + +'[SOLID](#solid)' prensiplerinin dördüncüsüdür ve bir bileşenin kullanıcılarının, kullanmadığı bir bileşenin işlevlerine bağımlı olmaması gerektiğini belirtir. + +Örnek olarak dosyayı temsil eden bir yapıdan XML verisi okuyan bir metod düşünelim. Bu metod sadece dosyadan byte byte veri okumalı ve dosya içinde ileri ya da geri hareket etmeli. Eğer bu method dosya okuma dışında (dosya izinleri değişimi gibi) herhangi bir özellik değişiminden dolayı güncellenmek zorunda kalınıyorsa bu prensip ihlal edilmiş demektir. + +Bı prensip de nesne-tabanlı programlama ile direk ilişkilidir. 'interface' yapıları, sınıf hiyerarşileri ve soyut türler farklı bileşenler arası bağımlığı [en aza indirmek](#todo) için kullanılır. [Duck typing](#todo) de bu prensibi uygulamaya yardımcı olur. + +See also: + +- [Nesne Tabanlı Programlama](#todo) +- [SOLID](#solid) +- [Duck Typing](#todo) +- [Decoupling](#todo) + +### Bağımlılığın Ters Çevrilmesi + +[Wikipedia'da Bağımlılığın Ters Çevrilmesi](https://en.wikipedia.org/wiki/Dependency_inversion_principle) + +> Yüksek seviye modülleri, düşük seviye uygulamalarına bağlı olmamalıdır. + +'[SOLID](#solid)' prensiplerin beşincisidir. Bu ilke, daha üst seviye bileşenlerinin bağımlılıklarının ayrıntılarını bilmek zorunda olmadıklarını belirtir. + +Örnek olarak bir web sitesinden metadata okuyan bir program düşünelim. Bu programın ana bileşeninin web sitesinden içeriği indiren ve metadayı okuyan bileşenlerinden ne yaptığından haberdar olması gerekir. Eğer bu prensibe uyarsak ana bileşenin byte verisi okuyan ve byte verisinden metada çıkaran soyutlamalara bağımlı olması lazım. Ana bileşenin TCP/IP, HTTP ya da HTML hakında bir detaya hakim olmasına gerek yoktur. + +Bu prensip olması gereken bağımlığı tersine çevirdiği düşünebileceğinden (isminden dolayı) biraz karmaşık gelebilir. Pratikte, ayrı bir düzenleme bileşeninin, soyut türlerin doğru uygulamalarının kullanılmasını sağlaması gerektiği anlamına gelir (önceki örnekte, *bir şey* hala meta veri okuyucu bileşenine bir HTTP dosyası indiricisi ve HTML meta etiketi okuyucu sağlamalıdır). Bu prensip aynı zamanda [Kontrolün Ters Çevirilmesi](#todo) ve [Bağımlık Enjeksiyonu](#todo) gibi konularla da bağlantılıdır. + + +Ek kaynaklar: + +- [Nesne Tabanlı Programlama](#todo) +- [SOLID](#solid) +- [Bağımlılığın Ters Çevrilmesi](#todo) +- [Dependency Injection](#todo) + +### DRY Prensibi + +[Wikipedia'da DRY Prensibi](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself) + +> Her bilgi parçasının bir sistem içinde tek, açık ve net bir temsiline sahip olması gerekir. + +*DRY Don't Repeat Yourself* yani Kendini Tekrar Etme deyimin kısaltılmasıdır. İlk olarak Andrew Hunt ve Dave Thomas tarafından [The Pragmatic Developer](https://en.wikipedia.org/wiki/The_Pragmatic_Programmer) kitabında bahsedilmiştir. Bu ilke, geliştiricilere kod tekrarını azaltma ve bilgileri tek bir yerde tutmalarına yardımcı olmayı amaçlamaktadır. + + +> DRY'nin tam tersi *WET* olacaktır (Write Everything Twice (Her Şeyi İki Kez Yaz) We Enjoy Typing (Yazmayı Seviyoruz)). +> + +Uygulamada, aynı bilgi parçasını iki (veya daha fazla) farklı yerde kullanıyorsanız, DRY'yi bunları tek bir tanede birleştirmek ve istediğiniz / ihtiyaç duyduğunuz yerde tekrar kullanmak için kullanabilirsiniz. + +Ek kaynaklar: + +- [The Pragmatic Developer](https://en.wikipedia.org/wiki/The_Pragmatic_Programmer) + +### YAGNI + +[Wikipedia'da YAGNI](https://en.wikipedia.org/wiki/You_aren%27t_gonna_need_it) + +***Y**ou **A**ren't **G**onna **N**eed **I**t* (İhtiyacın olmayacak) deyiminin kısaltmasıdır. + +> İhtiyaç duyduğunuz şeyleri her zaman ihtiyaç duyduğunuzda geliştirin, onlara ihtiyacınız olacağını düşündüğünüzde değil. +> ([Ron Jeffries](https://twitter.com/RonJeffries)) (XP eş-kurucusu and "Extreme Programming Installed" kitabının yazarı) + +Bu *Aşırı Programlama* (XP) ilkesi, geliştiricilerin yalnızca acil gereksinimler için gerekli olan işlevleri yerine getirmeleri gerektiğini ve daha sonra ihtiyaç duyulabilecek işlevleri uygulayarak geleceği tahmin etme girişimlerinden kaçınmalarını önerir. + +Bu ilkeye bağlı kalmak, kod tabanındaki kullanılmayan kod miktarının ve hiçbir değer getirmeyen işlevlerde haracanan zamanın ve çabanın azalmasını sağlayacaktır. + +Ek kaynaklar: + +- [Reading List: Extreme Programming Installed](#reading-list) + +## Ek Kaynaklar + +Bu kavramları ilginç bulduysanız, aşağıdaki kitapların keyfini çıkarabilirsiniz. + +- [Extreme Programming Installed - Ron Jeffries, Ann Anderson, Chet Hendrikson](https://www.goodreads.com/en/book/show/67834) - Covers the core principles of Extreme Programming. +- [The Mythical Man Month - Frederick P. Brooks Jr.](https://www.goodreads.com/book/show/13629.The_Mythical_Man_Month) - A classic volume on software engineering. [Brooks' Law](#brooks-law) is a central theme of the book. +- [Gödel, Escher, Bach: An Eternal Golden Braid - Douglas R. Hofstadter.](https://www.goodreads.com/book/show/24113.G_del_Escher_Bach) - This book is difficult to classify. [Hofstadter's Law](#hofstadters-law) is from the book. + +## TODO + +Selam!. Buraya ulaştıysanız, henüz yazmadığım bir konunun bağlantısını tıkladınız, bunun için üzgünüm - ve en kısa zamanda tamamlamaya çalışacağım! + +Soru ve önerileriniz için [issue](https://github.com/dwmkerr/hacker-laws/issues) açabilirsiniz, ya da katkıda bulunmak isterseniz [Pull Request](https://github.com/dwmkerr/hacker-laws/pulls) açabilirsiniz. + From f38499449f6a92cc1a6cbd6ce215ca43ee5cbe0d Mon Sep 17 00:00:00 2001 From: machine-translation Date: Fri, 28 Jun 2019 16:20:49 +0300 Subject: [PATCH 26/37] Translate tr.md via GitLocalize --- translations/tr.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/translations/tr.md b/translations/tr.md index b856faa..99f24b1 100644 --- a/translations/tr.md +++ b/translations/tr.md @@ -14,7 +14,7 @@ Programcıların faydalı bulacağı yasalar, teoriler, prensipler ve desenler. - [Giriş](#introduction) - [Yasalar](#laws) - [Amdahl Yasası](#amdahls-law) - - [Brooks' Law](#brooks-law) + - [Brooks Yasası](#brooks-law) - [Conway Yasası](#conways-law) - [Dunbar Sayısı](#dunbars-number) - [Hanlon'un Usturası](#hanlons-razor) @@ -265,7 +265,7 @@ Ek kaynaklar: - [Hyrum Yasası](#hyrums-law-the-law-of-implicit-interfaces) -Real-world examples: +Gerçek dünyadan örnekler: - [Photoshop'taki yavaş açılma problemi](https://forums.adobe.com/thread/376152): Photoshop bir zamanlar çok yavaş açılırdı, hatta bazen açılması dakikalar sürerdi. Sorunun sebebi program her başlangıçta ön tanımlı yazıcı ile ilgili belli bilgileri çekmeye çalışması olarak gözüküyordu. Eğer yazıcı bir ağ yazıcısıysa açılma daha da uzun sürüyordu. Ağ yazıcılarının yerel yazıcıları gibi *soyutlanması* kullanıcılara bu kötü deneyimi yaşatmış oldu. @@ -432,7 +432,7 @@ See also: - [Nesne Tabanlı Programlama](#todo) - [SOLID](#solid) - [Duck Typing](#todo) -- [Decoupling](#todo) +- [Ayrışma](#todo) ### Bağımlılığın Ters Çevrilmesi @@ -452,7 +452,7 @@ Ek kaynaklar: - [Nesne Tabanlı Programlama](#todo) - [SOLID](#solid) - [Bağımlılığın Ters Çevrilmesi](#todo) -- [Dependency Injection](#todo) +- [Bağımlılık Enjeksiyonu](#todo) ### DRY Prensibi From 2cb6fcda1b159ca3ddcfc47041017efd4aeb914a Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Tue, 2 Jul 2019 19:18:13 +0800 Subject: [PATCH 27/37] docs: comments on how to localise (#130) --- .github/contributing.md | 18 +++++++++++++++++- images/gitlocalize.png | Bin 0 -> 109608 bytes 2 files changed, 17 insertions(+), 1 deletion(-) create mode 100644 images/gitlocalize.png diff --git a/.github/contributing.md b/.github/contributing.md index 6dc01bd..1a5fc6b 100644 --- a/.github/contributing.md +++ b/.github/contributing.md @@ -1,5 +1,13 @@ # Contributing Guidelines + + + +* [Example Law: The Law of Leaky Abstractions](#example-law-the-law-of-leaky-abstractions) +* [Localisation](#localisation) + + + The goal of this project is to have a set of _concise_ definitions to laws, principles, methodologies and patterns which hackers will find useful. They should be: 1. Short - one or two paragraphs. @@ -22,7 +30,7 @@ An example law is shown below, which covers most of the key points: --- -### The Law of Leaky Abstractions +### Example Law: The Law of Leaky Abstractions [The Law of Leaky Abstractions on Joel on Software](https://www.joelonsoftware.com/2002/11/11/the-law-of-leaky-abstractions/) @@ -45,3 +53,11 @@ See also: Real-world examples: - [Photoshop Slow Startup](https://forums.adobe.com/thread/376152) - an issue I encountered in the past. Photoshop would be slow to startup, sometimes taking minutes. It seems the issue was that on startup it reads some information about the current default printer. However, if that printer is actually a network printer, this could take an extremely long time. The _abstraction_ of a network printer being presented to the system similar to a local printer caused an issue for users in poor connectivity situations. + +### Localisation + +We are currently using [GitLocalize](https://gitlocalize.com) to handle translations. This provides features to make it easier for people to manage translations as changes come in: + +![GitLocalize Screenshot](../images/gitlocalize.png) + +This is still work in progress - if you would like to be a maintainer for a language just open an issue to get in touch! diff --git a/images/gitlocalize.png b/images/gitlocalize.png new file mode 100644 index 0000000000000000000000000000000000000000..9d3069f84d5128be9f8e1707835b235e9a9f4acd GIT binary patch literal 109608 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 z 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 Date: Mon, 8 Jul 2019 14:23:38 +0300 Subject: [PATCH 28/37] Translate tr.md via GitLocalize (#129) --- translations/tr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/translations/tr.md b/translations/tr.md index 99f24b1..39dcd13 100644 --- a/translations/tr.md +++ b/translations/tr.md @@ -373,7 +373,7 @@ Bu '[SOLID](#solid)' prensiplerinin ilkidir. Bu prensip der ki her bir sistem pa Teorik olarak, bu prensibe uygun yazılmış kodlar daha sağlam ve değiştirilmesi kolaydır. Sadece tek bir parçanın değiştirildiğine emin olunduğunda değişimi *tesk etmek* de kolay olacaktır. Önceki şifre örneğini düşünürsek, şifrenin zorluk seviyesi değiştirildiğinde sadece şifre ilgili bölümlerin etkilenecektir. Birden fazla sorumluluğu olan bir bölümde olan değişikliğin nereleri etkileceğini hesaplamak daha zordur. -Ek kaynaklar: +See also: - [Nesne Tabanlı Programlama](#todo) - [SOLID](#solid) @@ -410,7 +410,7 @@ See also: Bu prensip nesne-tabanlı programlamanın bağlı olduğu prensiplerden biridir ve geliştiricilerin kafasını karıştırmamak için sınıf hiyerarşisinin dikkatli tarasarlanması gerektiğini söyler. -Ek kaynaklar: +See also: - [Nesne Tabanlı Programlama](#todo) - [SOLID](#solid) From e6724f97f894c06ae5f1772ec28fa67f95a6ed8d Mon Sep 17 00:00:00 2001 From: Thomas Ferris Nicolaisen Date: Mon, 8 Jul 2019 13:25:59 +0200 Subject: [PATCH 29/37] feat: gall's law (#101) Closes #90. --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index d9f352b..f0042d9 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [Brooks' Law](#brooks-law) * [Conway's Law](#conways-law) * [Dunbar's Number](#dunbars-number) + * [Gall's Law](#galls-law) * [Hanlon's Razor](#hanlons-razor) * [Hofstadter's Law](#hofstadters-law) * [Hutber's Law](#hutbers-law) @@ -120,6 +121,14 @@ See also: - [Conway's Law](#conways-law) +### Gall's Law + +[Gall's Law on Wikipedia](https://en.m.wikipedia.org/wiki/John_Gall_(author)#Gall's_law) + +> A complex system that works is invariably found to have evolved from a simple system that worked. A complex system designed from scratch never works and cannot be patched up to make it work. You have to start over with a working simple system. + +This law is essentially an argument in favour of underspecification: it can be used to explain the success of systems like the World Wide Web and Blogosphere, which grew from simple to complex systems incrementally, and the failure of systems like CORBA, which began with complex specifications. Gall's Law has strong affinities to the practice of agile software development. + ### Hanlon's Razor [Hanlon's Razor on Wikipedia](https://en.wikipedia.org/wiki/Hanlon%27s_razor) From ae3525d71c7e3c07f6e21db4bb0ca566f4d4d703 Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Mon, 8 Jul 2019 19:32:03 +0800 Subject: [PATCH 30/37] docs: update gall's law content --- README.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index f0042d9..5e60eb3 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [Brooks' Law](#brooks-law) * [Conway's Law](#conways-law) * [Dunbar's Number](#dunbars-number) - * [Gall's Law](#galls-law) + * [Gall's Law](#galls-law) * [Hanlon's Razor](#hanlons-razor) * [Hofstadter's Law](#hofstadters-law) * [Hutber's Law](#hutbers-law) @@ -126,8 +126,16 @@ See also: [Gall's Law on Wikipedia](https://en.m.wikipedia.org/wiki/John_Gall_(author)#Gall's_law) > A complex system that works is invariably found to have evolved from a simple system that worked. A complex system designed from scratch never works and cannot be patched up to make it work. You have to start over with a working simple system. +> +> ([John Gall](https://en.m.wikipedia.org/wiki/John_Gall_(author))) -This law is essentially an argument in favour of underspecification: it can be used to explain the success of systems like the World Wide Web and Blogosphere, which grew from simple to complex systems incrementally, and the failure of systems like CORBA, which began with complex specifications. Gall's Law has strong affinities to the practice of agile software development. +Gall's Law implies that attempts to _design_ highly complex systems are likely to fail. Highly complex systems are rarely built in one go, but evolve instead from more simple systems. + +The classic example is the world-wide-web. In it's current state, it is a highly complex system. However, it was defined initially as a simple way to share content between academic institutions. It was very successful in meeting these goals and evolved to become more complex over time. + +See also: + +- [KISS (Keep It Simple, Stupid)](#TODO) ### Hanlon's Razor From 2fb97ddf998bb89dc6dc5b9ee79d3a759c821102 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Umut=20I=C5=9F=C4=B1k?= Date: Mon, 8 Jul 2019 18:14:25 +0300 Subject: [PATCH 31/37] Translate tr.md via GitLocalize --- translations/tr.md | 38 ++++++++++++++++++++++++++++---------- 1 file changed, 28 insertions(+), 10 deletions(-) diff --git a/translations/tr.md b/translations/tr.md index 39dcd13..1008d9e 100644 --- a/translations/tr.md +++ b/translations/tr.md @@ -17,6 +17,7 @@ Programcıların faydalı bulacağı yasalar, teoriler, prensipler ve desenler. - [Brooks Yasası](#brooks-law) - [Conway Yasası](#conways-law) - [Dunbar Sayısı](#dunbars-number) + - [Gall Yasası](#galls-law) - [Hanlon'un Usturası](#hanlons-razor) - [Hofstadter Yasası](#hofstadters-law) - [Hutber Yasası](#hutbers-law) @@ -120,6 +121,21 @@ Ek kaynaklar: - [Conway Yasası](#conways-law) +### Gall Yasası + +[Wikipedia'da Gall Yasası](https://en.m.wikipedia.org/wiki/John_Gall_(author)#Gall's_law) + +> Çalışan karmaşık bir sistemin her zaman işe yarayan daha basit bir sistemden evrimleştiği kesinlikle söylenebilir. Başlangıçtan itibaren karmaşık tasarlanmış bir sistemin asla çalışmayacağı ve sonradan da düzeltilemeyeceği kesindir. Çalışsan daha basit bir sistem ile başlamanız gerekir. +> ([John Gall](https://en.m.wikipedia.org/wiki/John_Gall_(author))) + +Gall Yasası der ki, çok karmaşık sistemleri *tasarlamaya* çalışmak her zaman başarısızlıkla sonuçlanır. Bu tür sistemlerin ilk denemede başarılı olmaları çok nadir görülür ama genellikle basit sistemlerden evrilirler. + +En klasik örnek günümüzdeki internettir. Şu an çok karmaşık bir sistemdir. Aslında başlangıçta sadece akademik kurumlar arası içerik paylaşımı olarak tanımlanmıştı. Bu tanımı karşılamada çok başarılı oldu ve zamanla gelişerek bugünkü karmaşık halini aldı. + +Ek kaynaklar: + +- [KISS (Keep It Simple, Stupid)](#TODO) + ### Hanlon'un Usturası [Wikipedia'da Hanlon'un Usturası](https://en.wikipedia.org/wiki/Hanlon%27s_razor) @@ -161,6 +177,7 @@ Bu yasa der ki; sistemde yapılan bir iyileştirme sistemin diğer taraflarında > Bir teknolojinin kısa vadede oluşacak etkisini abartıp, uzun vadede oluşacak etkisini hafife alıyoruz. > (Roy Amara) +> (Roy Amara) Hype Döngüsü bir teknolojinin zamanla yarattığı heyecan ve gelişiminin görsel olarak sunumudur ve Gartner tarafından ilk olarak oluşturulmuştur. En güzel anlatım aşağıdaki bir görsel ile yapılabilir: @@ -176,6 +193,7 @@ Kısaca anlatmak gerekirse, bu döngü her yeni teknolojinin ilk zamanlarında t > Belli sayıda kullanıcıya ulaştığında, servis sözleşmesinde ne demiş olduğunuzdan bağımsız olarak ürününüzün ya da sisteminizin bütün gözlemlenebilir davranışları artık üçüncü kişilere göre şekillenecektir. > (Hyrum Wright) +> (Hyrum Wright) Hyrum Yasası göre, eğer bir API'nin *oldukça büyük sayılabilecek sayıda kullanıcısı* olduğunda, artık bütün sonuçlar ve davranışlar (API sözleşmesinde belirtilmemiş olsalar bile) kullanıcılara göre şekillenecektir. Buna bir örnek olarak bir API'nin tepki süresi olabilir. Daha kapsamlı bir örnek olarak kullanıcıların bir regex ile dönen cevap metninin içinden hatanın *tipini* ayıkladıkları bir senaryoyu düşünelim. API sözleşmesinde bu cevap metinleri ile ilgili bir şey belirtilmemiş olmasına ve kullanıcıların hata kodunu kullanmalarını belirtilmesine rağmen, cevap metnini değiştirmeniz *bazı* kullanıcıların metni kullanmalarından dolayı hata ile karşılaşmalarına sebep olacaktır. @@ -204,7 +222,7 @@ Bu yasa ile [Hofstadter Yasası](#hofstadters-law) birleştirilirse, daha kötü Ek kaynaklar: -- [Hofstadter's Law](#hofstadters-law) +- [Hofstadter Yasası](#hofstadters-law) ### Olgunlaşmamış Optimizasyon Etkisi @@ -252,6 +270,7 @@ O yasanın farklı bir yansıması olarak şöyle düşünülebilir, eğer bir k > Önemsiz sayılmayacak bütün soyutlamar belli ölçüde sızıntı içerir. > ([Joel Spolsky](https://twitter.com/spolsky)) +> ([Joel Spolsky](https://twitter.com/spolsky)) Bu yasa, karmaşık sistemleri sadeleştirmek için kullandığımız soyutlamaların bazı durumlarda soyutlamanın altındaki sistemin öğelerini sorunları ile birlikte sızdırır ve bu da beklenmedik davranışlar ortaya çıkması ile sonuçlanır. @@ -303,7 +322,7 @@ Spotify Modeli kabileler (Tribes), birlikler (Guilds) ve kısımlar (Chapter) gi > 1. Semantik > 2. Genel sözdizimi > 3. Sözcük sözdizimi -> 4. Yorumlardaki sözcük sözdizimi +> 4. Yorumlardaki sözcük sözdizimi(Kısaca semantic için harcanan her bir saat için yorumlardaki sözcük sözdizimi için sekiz saat harcanacaktır.) > (Kısaca semantic için harcanan her bir saat için yorumlardaki sözcük sözdizimi için sekiz saat harcanacaktır.) [Önemsizlik Yasasında](#the-law-of-triviality) öne sürülene benzer olarak, Wadler Yasası yeni bir programlama dili tasarlanırken konunun önemi ile o konu için harcanan zaman ters orantılı olduğunu söylüyor. @@ -335,7 +354,7 @@ Pareto Prensibi der ki, çıktıların önemli bir çoğunluğu girdilerin çok Bu prensip aynı zamanda 80/20 Kuralı (The Law of the Vital Few and The Principle of Factor Sparsity) olarak da bilinir. -Real-world examples: +Gerçek dünyadan örnekler: - 2002'de Microsoft en çok rapor edilen hataların üstten %20'sini çözünce kullanıcıların yaşadığı sorunların %80'inin çözüldüğünü gözlemlemiş ([Referans](https://www.crn.com/news/security/18821726/microsofts-ceo-80-20-rule-applies-to-bugs-not-just-features.htm)). @@ -373,7 +392,7 @@ Bu '[SOLID](#solid)' prensiplerinin ilkidir. Bu prensip der ki her bir sistem pa Teorik olarak, bu prensibe uygun yazılmış kodlar daha sağlam ve değiştirilmesi kolaydır. Sadece tek bir parçanın değiştirildiğine emin olunduğunda değişimi *tesk etmek* de kolay olacaktır. Önceki şifre örneğini düşünürsek, şifrenin zorluk seviyesi değiştirildiğinde sadece şifre ilgili bölümlerin etkilenecektir. Birden fazla sorumluluğu olan bir bölümde olan değişikliğin nereleri etkileceğini hesaplamak daha zordur. -See also: +Ek kaynaklar: - [Nesne Tabanlı Programlama](#todo) - [SOLID](#solid) @@ -389,12 +408,11 @@ Bu '[SOLID](#solid)' prensiplerinin ikincisidir ve herhangi bir sistem parçası Örneğin Markdown formatındaki belgeleri HTML formatına çeviren bir modülü düşünelim. Eğer bu modül kendisi değiştirilmeden yeni bir Markdown formatını da işlemesi sağlanacak şekilde geliştirilebiliyorsa, bu modül genişletilmeye açık demektir. Eğer sonradan değiştirilip Markdown formatı işlemesi ile ilgili geliştirme *yapılamıyorsa*, bu modül değiştirilmeye *kapalı* demektir. - Bu prensip nesne-tabanlı programlamaya tam uygundur. Şöyle ki, kendi nesne ve sınıflarımızı miras alınarak geliştirmeye uygun ve değiştirmeye ihtiyaç duymayacak şekilde tasarlarsak ve yazarsak nesne-tabanlı programlamaya tam uygun kod yazmış oluruz. -See also: +Ek kaynaklar: -- [Object-Oriented Programming](#todo) +- [Nesne Tabanlı Programlama](#todo) - [SOLID](#solid) ### Liskov Yerine Geçme Prensibi @@ -410,7 +428,7 @@ See also: Bu prensip nesne-tabanlı programlamanın bağlı olduğu prensiplerden biridir ve geliştiricilerin kafasını karıştırmamak için sınıf hiyerarşisinin dikkatli tarasarlanması gerektiğini söyler. -See also: +Ek kaynaklar: - [Nesne Tabanlı Programlama](#todo) - [SOLID](#solid) @@ -427,7 +445,7 @@ See also: Bı prensip de nesne-tabanlı programlama ile direk ilişkilidir. 'interface' yapıları, sınıf hiyerarşileri ve soyut türler farklı bileşenler arası bağımlığı [en aza indirmek](#todo) için kullanılır. [Duck typing](#todo) de bu prensibi uygulamaya yardımcı olur. -See also: +Ek kaynaklar: - [Nesne Tabanlı Programlama](#todo) - [SOLID](#solid) @@ -464,7 +482,6 @@ Ek kaynaklar: > DRY'nin tam tersi *WET* olacaktır (Write Everything Twice (Her Şeyi İki Kez Yaz) We Enjoy Typing (Yazmayı Seviyoruz)). -> Uygulamada, aynı bilgi parçasını iki (veya daha fazla) farklı yerde kullanıyorsanız, DRY'yi bunları tek bir tanede birleştirmek ve istediğiniz / ihtiyaç duyduğunuz yerde tekrar kullanmak için kullanabilirsiniz. @@ -480,6 +497,7 @@ Ek kaynaklar: > İhtiyaç duyduğunuz şeyleri her zaman ihtiyaç duyduğunuzda geliştirin, onlara ihtiyacınız olacağını düşündüğünüzde değil. > ([Ron Jeffries](https://twitter.com/RonJeffries)) (XP eş-kurucusu and "Extreme Programming Installed" kitabının yazarı) +> ([Ron Jeffries](https://twitter.com/RonJeffries)) (XP eş-kurucusu and "Extreme Programming Installed" kitabının yazarı) Bu *Aşırı Programlama* (XP) ilkesi, geliştiricilerin yalnızca acil gereksinimler için gerekli olan işlevleri yerine getirmeleri gerektiğini ve daha sonra ihtiyaç duyulabilecek işlevleri uygulayarak geleceği tahmin etme girişimlerinden kaçınmalarını önerir. From 2d397ea74446d571a82af124efd2831a4610ad5a Mon Sep 17 00:00:00 2001 From: Rodrigo Date: Tue, 9 Jul 2019 10:23:05 -0300 Subject: [PATCH 32/37] Fixing Wikipedia links that pointed to mobile exclusively. --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 5e60eb3..8c23e7d 100644 --- a/README.md +++ b/README.md @@ -84,7 +84,7 @@ See also: ### Brooks' Law -[Brooks' Law on Wikipedia](https://en.m.wikipedia.org/wiki/Brooks%27s_law) +[Brooks' Law on Wikipedia](https://en.wikipedia.org/wiki/Brooks%27s_law) > Adding human resources to a late software development project makes it later. @@ -123,11 +123,11 @@ See also: ### Gall's Law -[Gall's Law on Wikipedia](https://en.m.wikipedia.org/wiki/John_Gall_(author)#Gall's_law) +[Gall's Law on Wikipedia](https://en.wikipedia.org/wiki/John_Gall_(author)#Gall's_law) > A complex system that works is invariably found to have evolved from a simple system that worked. A complex system designed from scratch never works and cannot be patched up to make it work. You have to start over with a working simple system. > -> ([John Gall](https://en.m.wikipedia.org/wiki/John_Gall_(author))) +> ([John Gall](https://en.wikipedia.org/wiki/John_Gall_(author))) Gall's Law implies that attempts to _design_ highly complex systems are likely to fail. Highly complex systems are rarely built in one go, but evolve instead from more simple systems. From b781ce9d4d3f61405cf927478480cb108fba0ac2 Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Mon, 22 Jul 2019 22:08:14 +0800 Subject: [PATCH 33/37] feat: murphy's law --- README.md | 30 ++++++++++++++++++++---------- 1 file changed, 20 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 9d8dd19..44e0754 100644 --- a/README.md +++ b/README.md @@ -30,10 +30,10 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [The Law of Conservation of Complexity (Tesler's Law)](#the-law-of-conservation-of-complexity-teslers-law) * [The Law of Leaky Abstractions](#the-law-of-leaky-abstractions) * [The Law of Triviality](#the-law-of-triviality) + * [Murphy's Law / Sod's Law](#murphys-law--sods-law) * [The Unix Philosophy](#the-unix-philosophy) * [The Spotify Model](#the-spotify-model) * [Wadler's Law](#wadlers-law) - * [Murphy's Law](#murphys-law) * [Principles](#principles) * [The Pareto Principle (The 80/20 Rule)](#the-pareto-principle-the-8020-rule) * [The Robustness Principle (Postel's Law)](#the-robustness-principle-postels-law) @@ -308,6 +308,25 @@ The common fictional example used is that of a committee approving plans for nuc The fictional example above led to the usage of the term 'Bike Shedding' as an expression for wasting time on trivial details. +### Murphy's Law / Sod's Law + +[Murphy's Law on Wikipedia](https://en.wikipedia.org/wiki/Murphy%27s_law) + +> Anything that can go wrong will go wrong. + +Related to [Edward A. Murphy, Jr](https://en.wikipedia.org/wiki/Edward_A._Murphy_Jr.) _Murphy's Law_ states that if a thing can go wrong, it will go wrong. + +This is a common adage among developers. Sometimes the unexpected happens when developing, testing or even in production. This can also be related to the (more common in British English) _Sod's Law_: + +> If something can go wrong, it will, at the worst possible time. + +These 'laws' are generally used in a comic sense. However, phenomena such as [_Confirmation Bias_](#TODO) and [_Selection Bias_](#TODO) can lead people to perhaps over-emphasise these laws (the majority of times when things work, they go unnoticed, failures however are more noticeable and draw more discussion). + +See Also: + +- [Confirmation Bias](#TODO) +- [Selection Bias](#TODO) + ### The Unix Philosophy [The Unix Philosophy on Wikipedia](https://en.wikipedia.org/wiki/Unix_philosophy) @@ -343,15 +362,6 @@ See also: - [The Law of Triviality](#the-law-of-triviality) -### Murphy's Law - -[Murphy's Law on Wikipedia](https://en.wikipedia.org/wiki/Murphy%27s_law) - -> Anything that can go wrong will go wrong. - -Related to [Edward A. Murphy, Jr](https://en.wikipedia.org/wiki/Edward_A._Murphy_Jr.), the _Murphy's Law_ states that if a thing can go wrong, it'll go wrong. - -Even though it's a funny joke among developers, sometimes things go crazy when developing, testing or even when in production. ## Principles From 687674125a662be3597c3c6de80de1305fca26b7 Mon Sep 17 00:00:00 2001 From: Dave Kerr Date: Mon, 22 Jul 2019 22:09:00 +0800 Subject: [PATCH 34/37] chore: fix alphabetic ordering! --- README.md | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 44e0754..7ef9352 100644 --- a/README.md +++ b/README.md @@ -24,13 +24,13 @@ Laws, Theories, Principles and Patterns that developers will find useful. * [The Hype Cycle & Amara's Law](#the-hype-cycle--amaras-law) * [Hyrum's Law (The Law of Implicit Interfaces)](#hyrums-law-the-law-of-implicit-interfaces) * [Moore's Law](#moores-law) + * [Murphy's Law / Sod's Law](#murphys-law--sods-law) * [Parkinson's Law](#parkinsons-law) * [Premature Optimization Effect](#premature-optimization-effect) * [Putt's Law](#putts-law) * [The Law of Conservation of Complexity (Tesler's Law)](#the-law-of-conservation-of-complexity-teslers-law) * [The Law of Leaky Abstractions](#the-law-of-leaky-abstractions) * [The Law of Triviality](#the-law-of-triviality) - * [Murphy's Law / Sod's Law](#murphys-law--sods-law) * [The Unix Philosophy](#the-unix-philosophy) * [The Spotify Model](#the-spotify-model) * [Wadler's Law](#wadlers-law) @@ -218,6 +218,25 @@ See also: Often used to illustrate the sheer speed at which semiconductor and chip technology has improved, Moore's prediction has proven to be highly accurate over from the 1970s to the late 2000s. In more recent years, the trend has changed slightly, partly due to [physical limitations on the degree to which components can be miniaturised](https://en.wikipedia.org/wiki/Quantum_tunnelling). However, advancements in parallelisation, and potentially revolutionary changes in semiconductor technology and quantum computing may mean that Moore's Law could continue to hold true for decades to come. +### Murphy's Law / Sod's Law + +[Murphy's Law on Wikipedia](https://en.wikipedia.org/wiki/Murphy%27s_law) + +> Anything that can go wrong will go wrong. + +Related to [Edward A. Murphy, Jr](https://en.wikipedia.org/wiki/Edward_A._Murphy_Jr.) _Murphy's Law_ states that if a thing can go wrong, it will go wrong. + +This is a common adage among developers. Sometimes the unexpected happens when developing, testing or even in production. This can also be related to the (more common in British English) _Sod's Law_: + +> If something can go wrong, it will, at the worst possible time. + +These 'laws' are generally used in a comic sense. However, phenomena such as [_Confirmation Bias_](#TODO) and [_Selection Bias_](#TODO) can lead people to perhaps over-emphasise these laws (the majority of times when things work, they go unnoticed, failures however are more noticeable and draw more discussion). + +See Also: + +- [Confirmation Bias](#TODO) +- [Selection Bias](#TODO) + ### Parkinson's Law [Parkinson's Law on Wikipedia](https://en.wikipedia.org/wiki/Parkinson%27s_law) @@ -308,25 +327,6 @@ The common fictional example used is that of a committee approving plans for nuc The fictional example above led to the usage of the term 'Bike Shedding' as an expression for wasting time on trivial details. -### Murphy's Law / Sod's Law - -[Murphy's Law on Wikipedia](https://en.wikipedia.org/wiki/Murphy%27s_law) - -> Anything that can go wrong will go wrong. - -Related to [Edward A. Murphy, Jr](https://en.wikipedia.org/wiki/Edward_A._Murphy_Jr.) _Murphy's Law_ states that if a thing can go wrong, it will go wrong. - -This is a common adage among developers. Sometimes the unexpected happens when developing, testing or even in production. This can also be related to the (more common in British English) _Sod's Law_: - -> If something can go wrong, it will, at the worst possible time. - -These 'laws' are generally used in a comic sense. However, phenomena such as [_Confirmation Bias_](#TODO) and [_Selection Bias_](#TODO) can lead people to perhaps over-emphasise these laws (the majority of times when things work, they go unnoticed, failures however are more noticeable and draw more discussion). - -See Also: - -- [Confirmation Bias](#TODO) -- [Selection Bias](#TODO) - ### The Unix Philosophy [The Unix Philosophy on Wikipedia](https://en.wikipedia.org/wiki/Unix_philosophy) From 8072aaccc2da865bde15867ea6deb2b00d31264e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Umut=20I=C5=9F=C4=B1k?= Date: Tue, 23 Jul 2019 22:16:02 +0300 Subject: [PATCH 35/37] Translate tr.md via GitLocalize --- translations/tr.md | 37 +++++++++++++++++++++++-------------- 1 file changed, 23 insertions(+), 14 deletions(-) diff --git a/translations/tr.md b/translations/tr.md index 1008d9e..b0f5e12 100644 --- a/translations/tr.md +++ b/translations/tr.md @@ -24,6 +24,7 @@ Programcıların faydalı bulacağı yasalar, teoriler, prensipler ve desenler. - [Hype Döngüsü ve Amara Yasası](#the-hype-cycle--amaras-law) - [Hyrum Yasası (Arabirimlerin Örtülü Hukuku)](#hyrums-law-the-law-of-implicit-interfaces) - [Moore Yasası](#moores-law) + - [Murphy Yasası / Sod Yasası](#murphys-law--sods-law) - [Parkinson Yasası](#parkinsons-law) - [Olgunlaşmamış Optimizasyon Etkisi](#premature-optimization-effect) - [Putt Yasası](#putts-law) @@ -84,7 +85,7 @@ Ek kaynaklar: ### Brooks Yasası -[Wikipedia'da Brooks Yasası](https://en.m.wikipedia.org/wiki/Brooks%27s_law) +[Wikipedia'da Brooks Yasası](https://en.wikipedia.org/wiki/Brooks%27s_law) > Gecikmesi kesinleşmiş projeye yeni insan kaynağı eklemek projeyi daha da geciktirir. @@ -123,7 +124,7 @@ Ek kaynaklar: ### Gall Yasası -[Wikipedia'da Gall Yasası](https://en.m.wikipedia.org/wiki/John_Gall_(author)#Gall's_law) +[Wikipedia'da Gall Yasası](https://en.wikipedia.org/wiki/John_Gall_(author)#Gall's_law) > Çalışan karmaşık bir sistemin her zaman işe yarayan daha basit bir sistemden evrimleştiği kesinlikle söylenebilir. Başlangıçtan itibaren karmaşık tasarlanmış bir sistemin asla çalışmayacağı ve sonradan da düzeltilemeyeceği kesindir. Çalışsan daha basit bir sistem ile başlamanız gerekir. > ([John Gall](https://en.m.wikipedia.org/wiki/John_Gall_(author))) @@ -177,7 +178,6 @@ Bu yasa der ki; sistemde yapılan bir iyileştirme sistemin diğer taraflarında > Bir teknolojinin kısa vadede oluşacak etkisini abartıp, uzun vadede oluşacak etkisini hafife alıyoruz. > (Roy Amara) -> (Roy Amara) Hype Döngüsü bir teknolojinin zamanla yarattığı heyecan ve gelişiminin görsel olarak sunumudur ve Gartner tarafından ilk olarak oluşturulmuştur. En güzel anlatım aşağıdaki bir görsel ile yapılabilir: @@ -193,7 +193,6 @@ Kısaca anlatmak gerekirse, bu döngü her yeni teknolojinin ilk zamanlarında t > Belli sayıda kullanıcıya ulaştığında, servis sözleşmesinde ne demiş olduğunuzdan bağımsız olarak ürününüzün ya da sisteminizin bütün gözlemlenebilir davranışları artık üçüncü kişilere göre şekillenecektir. > (Hyrum Wright) -> (Hyrum Wright) Hyrum Yasası göre, eğer bir API'nin *oldukça büyük sayılabilecek sayıda kullanıcısı* olduğunda, artık bütün sonuçlar ve davranışlar (API sözleşmesinde belirtilmemiş olsalar bile) kullanıcılara göre şekillenecektir. Buna bir örnek olarak bir API'nin tepki süresi olabilir. Daha kapsamlı bir örnek olarak kullanıcıların bir regex ile dönen cevap metninin içinden hatanın *tipini* ayıkladıkları bir senaryoyu düşünelim. API sözleşmesinde bu cevap metinleri ile ilgili bir şey belirtilmemiş olmasına ve kullanıcıların hata kodunu kullanmalarını belirtilmesine rağmen, cevap metnini değiştirmeniz *bazı* kullanıcıların metni kullanmalarından dolayı hata ile karşılaşmalarına sebep olacaktır. @@ -210,6 +209,25 @@ Ek kaynaklar: Çoğu zaman yarı-iletken ve çip teknolojisinin gelişim hızını tahmin etmek için kullanılan Moore yasasının, 1970'lerden 2000'lerin sonlarına doğru oldukça doğru olduğu biliyoruz. Son yıllarda, [komponentlerin küçülmesinde fiziksel sınırlara](https://en.wikipedia.org/wiki/Quantum_tunnelling) ulaşıldığı için bu tahminlemenin tutmadığını da söyleyebiliriz. Ama paralelleştirmede uzmanlaşılması ve yarı-iletken teknolojilerindeki devrim potansiyelindeki değişiklikler Moore Yasası'nın yakın zamanda tekrar doğrulanacağını tahminler yapabileceğini düşünebiliriz. +### Murphy Yasası / Sod Yasası + +[Wikipedia'da Murphy Yasası](https://en.wikipedia.org/wiki/Murphy%27s_law) + +> Eğer bir işin kötü gitme ihtimali varsa mutlaka kötü gider. + +İsmini [Edward A. Murphy, Jr](https://en.wikipedia.org/wiki/Edward_A._Murphy_Jr.)'dan alan *Murphy's Yasası* der ki eğer bir işin kötü gitme ihtimali varsa mutlaka kötü gider. + +Bu programcılar arasında çok kullanılan bir atasözüdür. Geliştirme yaparken, test ederken ya da canlı sistemlerde çoğunlukla hep beklenmedik sorunlar olur. Bu durum (İngiltere'de yaygın kullanılan) *Sod Yasası* ile de ilişkilendirilebilir: + +> Eğer bir işin kötü gitme ihtimali varsa, olabilecek en kötü zamanda kötüye gidecektir. + +Bu iki 'yasa' daha çok espri amaçlı kullanılır. Bunun yanında, [*Doğrulama Önyargısı*](#TODO) ve [*Seçim Tarafgirliği*](#TODO) gibi olgular bu yasaların insanlar tarafında çok fazla vurgulanmasına sebep olabilir (işler yolundayken hiçbirşeye dikkat etmeyiz, ama bunun yanında sorunlar yaşanınca herşey göze batmaya başlar ve tartışılır). + +Ek kaynaklar: + +- [Doğrulama Önyargısı](#TODO) +- [Seçim Tarafgirliği](#TODO) + ### Parkinson Yasası [Wikipedia'da Parkinson Yasası](https://en.wikipedia.org/wiki/Parkinson%27s_law) @@ -270,7 +288,6 @@ O yasanın farklı bir yansıması olarak şöyle düşünülebilir, eğer bir k > Önemsiz sayılmayacak bütün soyutlamar belli ölçüde sızıntı içerir. > ([Joel Spolsky](https://twitter.com/spolsky)) -> ([Joel Spolsky](https://twitter.com/spolsky)) Bu yasa, karmaşık sistemleri sadeleştirmek için kullandığımız soyutlamaların bazı durumlarda soyutlamanın altındaki sistemin öğelerini sorunları ile birlikte sızdırır ve bu da beklenmedik davranışlar ortaya çıkması ile sonuçlanır. @@ -322,7 +339,7 @@ Spotify Modeli kabileler (Tribes), birlikler (Guilds) ve kısımlar (Chapter) gi > 1. Semantik > 2. Genel sözdizimi > 3. Sözcük sözdizimi -> 4. Yorumlardaki sözcük sözdizimi(Kısaca semantic için harcanan her bir saat için yorumlardaki sözcük sözdizimi için sekiz saat harcanacaktır.) +> 4. Yorumlardaki sözcük sözdizimi > (Kısaca semantic için harcanan her bir saat için yorumlardaki sözcük sözdizimi için sekiz saat harcanacaktır.) [Önemsizlik Yasasında](#the-law-of-triviality) öne sürülene benzer olarak, Wadler Yasası yeni bir programlama dili tasarlanırken konunun önemi ile o konu için harcanan zaman ters orantılı olduğunu söylüyor. @@ -351,7 +368,6 @@ Pareto Prensibi der ki, çıktıların önemli bir çoğunluğu girdilerin çok 1940'lı yıllarda Romanya kökenli Amerikalı mühendis Dr. Joseph Juran, kendisi kalite kontrolün babası olarak nitelendirilir, [kalite kontrol sorunlarında Pareto Prensibini kullanmaya başladı](https://en.wikipedia.org/wiki/Joseph_M._Juran). - Bu prensip aynı zamanda 80/20 Kuralı (The Law of the Vital Few and The Principle of Factor Sparsity) olarak da bilinir. Gerçek dünyadan örnekler: @@ -380,7 +396,6 @@ SOLID aşağıdaki beş prensibin baş harflerinden oluşan bir kısaltmadır; Bunları [Nesne Tabanlı Proglamlama'nın](#todo) temel prensipleri olarak değerlendirilebilir ve bu prensiplerin programcılara geliştirilebilir ve desteklenebilir sistemler geliştirmelerinde yardımcı oldukları kesindir. - ### Tek Sorumluluk Prensibi [Wikipedia'da Tek Sorumluluk Prensibi](https://en.wikipedia.org/wiki/Single_responsibility_principle) @@ -391,7 +406,6 @@ Bu '[SOLID](#solid)' prensiplerinin ilkidir. Bu prensip der ki her bir sistem pa Teorik olarak, bu prensibe uygun yazılmış kodlar daha sağlam ve değiştirilmesi kolaydır. Sadece tek bir parçanın değiştirildiğine emin olunduğunda değişimi *tesk etmek* de kolay olacaktır. Önceki şifre örneğini düşünürsek, şifrenin zorluk seviyesi değiştirildiğinde sadece şifre ilgili bölümlerin etkilenecektir. Birden fazla sorumluluğu olan bir bölümde olan değişikliğin nereleri etkileceğini hesaplamak daha zordur. - Ek kaynaklar: - [Nesne Tabanlı Programlama](#todo) @@ -405,7 +419,6 @@ Ek kaynaklar: Bu '[SOLID](#solid)' prensiplerinin ikincisidir ve herhangi bir sistem parçasının *mevcut* davranışının değiştirilememesini ama kullanılarak/türetilerek *genişletilebilmesinin* gerekliliğini savunur. - Örneğin Markdown formatındaki belgeleri HTML formatına çeviren bir modülü düşünelim. Eğer bu modül kendisi değiştirilmeden yeni bir Markdown formatını da işlemesi sağlanacak şekilde geliştirilebiliyorsa, bu modül genişletilmeye açık demektir. Eğer sonradan değiştirilip Markdown formatı işlemesi ile ilgili geliştirme *yapılamıyorsa*, bu modül değiştirilmeye *kapalı* demektir. Bu prensip nesne-tabanlı programlamaya tam uygundur. Şöyle ki, kendi nesne ve sınıflarımızı miras alınarak geliştirmeye uygun ve değiştirmeye ihtiyaç duymayacak şekilde tasarlarsak ve yazarsak nesne-tabanlı programlamaya tam uygun kod yazmış oluruz. @@ -464,7 +477,6 @@ Ek kaynaklar: Bu prensip olması gereken bağımlığı tersine çevirdiği düşünebileceğinden (isminden dolayı) biraz karmaşık gelebilir. Pratikte, ayrı bir düzenleme bileşeninin, soyut türlerin doğru uygulamalarının kullanılmasını sağlaması gerektiği anlamına gelir (önceki örnekte, *bir şey* hala meta veri okuyucu bileşenine bir HTTP dosyası indiricisi ve HTML meta etiketi okuyucu sağlamalıdır). Bu prensip aynı zamanda [Kontrolün Ters Çevirilmesi](#todo) ve [Bağımlık Enjeksiyonu](#todo) gibi konularla da bağlantılıdır. - Ek kaynaklar: - [Nesne Tabanlı Programlama](#todo) @@ -480,7 +492,6 @@ Ek kaynaklar: *DRY Don't Repeat Yourself* yani Kendini Tekrar Etme deyimin kısaltılmasıdır. İlk olarak Andrew Hunt ve Dave Thomas tarafından [The Pragmatic Developer](https://en.wikipedia.org/wiki/The_Pragmatic_Programmer) kitabında bahsedilmiştir. Bu ilke, geliştiricilere kod tekrarını azaltma ve bilgileri tek bir yerde tutmalarına yardımcı olmayı amaçlamaktadır. - > DRY'nin tam tersi *WET* olacaktır (Write Everything Twice (Her Şeyi İki Kez Yaz) We Enjoy Typing (Yazmayı Seviyoruz)). Uygulamada, aynı bilgi parçasını iki (veya daha fazla) farklı yerde kullanıyorsanız, DRY'yi bunları tek bir tanede birleştirmek ve istediğiniz / ihtiyaç duyduğunuz yerde tekrar kullanmak için kullanabilirsiniz. @@ -497,7 +508,6 @@ Ek kaynaklar: > İhtiyaç duyduğunuz şeyleri her zaman ihtiyaç duyduğunuzda geliştirin, onlara ihtiyacınız olacağını düşündüğünüzde değil. > ([Ron Jeffries](https://twitter.com/RonJeffries)) (XP eş-kurucusu and "Extreme Programming Installed" kitabının yazarı) -> ([Ron Jeffries](https://twitter.com/RonJeffries)) (XP eş-kurucusu and "Extreme Programming Installed" kitabının yazarı) Bu *Aşırı Programlama* (XP) ilkesi, geliştiricilerin yalnızca acil gereksinimler için gerekli olan işlevleri yerine getirmeleri gerektiğini ve daha sonra ihtiyaç duyulabilecek işlevleri uygulayarak geleceği tahmin etme girişimlerinden kaçınmalarını önerir. @@ -520,4 +530,3 @@ Bu kavramları ilginç bulduysanız, aşağıdaki kitapların keyfini çıkarabi Selam!. Buraya ulaştıysanız, henüz yazmadığım bir konunun bağlantısını tıkladınız, bunun için üzgünüm - ve en kısa zamanda tamamlamaya çalışacağım! Soru ve önerileriniz için [issue](https://github.com/dwmkerr/hacker-laws/issues) açabilirsiniz, ya da katkıda bulunmak isterseniz [Pull Request](https://github.com/dwmkerr/hacker-laws/pulls) açabilirsiniz. - From 02d6918831684d437abb4cb6660bdee5f17e0824 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Umut=20I=C5=9F=C4=B1k?= Date: Tue, 23 Jul 2019 22:24:47 +0300 Subject: [PATCH 36/37] Translate tr.md via GitLocalize --- translations/tr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/tr.md b/translations/tr.md index b0f5e12..a0643e2 100644 --- a/translations/tr.md +++ b/translations/tr.md @@ -215,7 +215,7 @@ Ek kaynaklar: > Eğer bir işin kötü gitme ihtimali varsa mutlaka kötü gider. -İsmini [Edward A. Murphy, Jr](https://en.wikipedia.org/wiki/Edward_A._Murphy_Jr.)'dan alan *Murphy's Yasası* der ki eğer bir işin kötü gitme ihtimali varsa mutlaka kötü gider. +İsmini [Edward A. Murphy, Jr](https://en.wikipedia.org/wiki/Edward_A._Murphy_Jr.)'dan alan *Murphy Yasası* der ki eğer bir işin kötü gitme ihtimali varsa mutlaka kötü gider. Bu programcılar arasında çok kullanılan bir atasözüdür. Geliştirme yaparken, test ederken ya da canlı sistemlerde çoğunlukla hep beklenmedik sorunlar olur. Bu durum (İngiltere'de yaygın kullanılan) *Sod Yasası* ile de ilişkilendirilebilir: From dbc0a6c9f523822041fc5ffabcbe2eb0f091f818 Mon Sep 17 00:00:00 2001 From: Claudio Sparpaglione Date: Thu, 1 Aug 2019 15:51:41 +0200 Subject: [PATCH 37/37] Italian translation (#137) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Theme for GH Pages * Starting baseline * TOC * Intro * Amdahl's law * Legge di Brooke * fix broken anchor * Legge di Conway * typo * Numero di Dunbar * Legge di Gall * Rasoio di Hanlon * legge di Hofstadter * Legge di Hutber * Hype Cycle e Legge di Amara * Legge di Hyrum * Legge di Moore * Legge di Parkinson * Ottimizzazione Prematura e Legge di Putt * Legge di Conservazione della Complessità * legge delle astrazioni fallate * legge di irrilevanza, filosofia Unix e Modello Spotify * legge di Wadler * fix * Pareto * Legge di Postel * SOLID - S e O * Completati i SOLID * Completed * Add reference to my repo * Copied from translations/it-IT.md * add reference to csparpa's repo * cleaned --- README.md | 1 + _config.yml | 0 translations/it-IT.md | 537 ++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 538 insertions(+) create mode 100644 _config.yml create mode 100644 translations/it-IT.md diff --git a/README.md b/README.md index 7ef9352..35178ae 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,7 @@ Laws, Theories, Principles and Patterns that developers will find useful. - 🇨🇳 [中文 / Chinese Version](https://github.com/nusr/hacker-laws-zh) - thanks [Steve Xu](https://github.com/nusr)! +- 🇮🇹 [Traduzione in Italiano](https://github.com/csparpa/hacker-laws-it) - grazie [Claudio Sparpaglione](https://github.com/csparpa)! - 🇰🇷 [한국어 / Korean Version](https://github.com/codeanddonuts/hacker-laws-kr) - thanks [Doughnut](https://github.com/codeanddonuts)! - 🇷🇺 [Русская версия / Russian Version](https://github.com/solarrust/hacker-laws) - thanks [Alena Batitskaya](https://github.com/solarrust)! - 🇹🇷 [Türkçe / Turkish Version](https://github.com/umutphp/hacker-laws-tr) - thanks [Umut Işık](https://github.com/umutphp) diff --git a/_config.yml b/_config.yml new file mode 100644 index 0000000..e69de29 diff --git a/translations/it-IT.md b/translations/it-IT.md new file mode 100644 index 0000000..78907b5 --- /dev/null +++ b/translations/it-IT.md @@ -0,0 +1,537 @@ +# 💻📖 hacker-laws + +Leggi, teorie, principi e pattern utili agli sviluppatori. + +- 🇨🇳 [中文 / Traduzione in Cinese](https://github.com/nusr/hacker-laws-zh) - grazie [Steve Xu](https://github.com/nusr)! +- 🇮🇹 [Traduzione in Italiano](https://github.com/csparpa/hacker-laws-it) - grazie [Claudio Sparpaglione](https://github.com/csparpa)! +- 🇰🇷 [한국어 / Traduzione in Coreano](https://github.com/codeanddonuts/hacker-laws-kr) - grazie [Doughnut](https://github.com/codeanddonuts)! +- 🇷🇺 [Русская версия / Traduzione in Russo](https://github.com/solarrust/hacker-laws) - grazie [Alena Batitskaya](https://github.com/solarrust)! +- 🇹🇷 [Türkçe / Traduzione in Turco](https://github.com/umutphp/hacker-laws-tr) - grazie [Umut Işık](https://github.com/umutphp)! +- 🇺🇸 [Original English Version - Versione Originale in Inglese](https://github.com/dwmkerr/hacker-laws) - grazie [Dave Kerr](https://github.com/dwmkerr)! + +--- + + + +* [Introduzione](#introduzione) +* [Leggi](#leggi) + * [Legge di Amdahl](#legge-di-amdahl) + * [Legge di Brooks](#legge-di-brooks) + * [Legge di Conway](#legge-di-conway) + * [Numero di Dunbar](#numero-di-dunbar) + * [Legge di Gall](#legge-di-gall) + * [Rasoio di Hanlon](#rasoio-di-hanlon) + * [Legge di Hofstadter](#legge-di-hofstadter) + * [Legge di Hutber](#legge-di-hutber) + * [Hype Cycle e Legge di Amara](#hype-cycle-e-legge-di-amara) + * [Legge di Hyrum (Legge delle Interfacce Implicite)](#legge-di-hyrum-legge-delle-interfacce-implicite) + * [Legge di Moore](#legge-di-moore) + * [Legge di Parkinson](#legge-di-parkinson) + * [Ottimizzazione Prematura](#effetto-di-ottimizzazione-prematura) + * [Legge di Putt](#legge-di-putt) + * [Legge di Conservazione della Complessità (Legge di Tesler)](#legge-di-conservazione-della-complessita-legge-di-tesler) + * [Legge dell'Astrazione Fallata](#legge-dell-astrazione-fallata) + * [Legge di Irrilevanza](#legge-di-irrilevanza) + * [Filosofia Unix](#filosofia-unix) + * [Il modello Spotify](#il-modello-spotify) + * [Legge di Wadler](#legge-di-wadler) +* [Principi](#principi) + * [Il Principo di Pareto (La regola dell'80/20)](#principio-di-pareto-regola-dell-80-20) + * [Il Principio di Robustezza (Legge di Postel's)](#principio-di-robustezza-legge-di-postel) + * [SOLID](#solid) + * [Il Principio di Singola Responsabilità](#principio-di-singola-responsabilita) + * [Il Principio dell'Aperto/Chiuso](#principio-dell-open-closed) + * [Il Principio di Sostituzione di Liskov](#principio-di-sostituzione-di-liskov) + * [Il Principio di Segregazione delle Interfacce](#principio-di-segregazione-delle-interfacce) + * [Il Principio di Inversione delle Dipendenze](#principio-di-inversione-delle-dipendenze) + * [Il Principio DRY](#principio-dry) + * [YAGNI](#yagni) +* [Reading List](#reading-list) +* [TODO](#todo) + + + +## Introduzione + +Quando si parla di sviluppo software, si discute di tanti principi. Questo repository fornisce un riferimento e un'introduzione a quelli più comuni. I contributi sono sono ben accetti! + + +❗: Questo repo contiene la spiegazione di alcune leggi, principi e pattern, ma tuttavia non ne _sponsorizza_ nessuno. La loro applicabilità dovrebbe sempre essere discussa ed è sempre dipendente dal progetto specifico su cui state lavorando. + +## Leggi + +Si parte! + +### Legge di Amdahl + +[Legge di Amdahl su Wikipedia](https://it.wikipedia.org/wiki/Legge_di_Amdahl) + +> La legge di Amdahl mostra lo _speedup potenziale_ che può essere raggiunto nell'esecuzione di un calcolo aumentando le risorse del sistema di calcolo. Di norma si usa nel calcolo parallelo e può stimare il beneficio atteso, limitato dalla porzione parallelizzabile del programma, e raggiungibile aumentando il numero di core di calcolo. + +Ecco un esempio illustrativo. Se un programma è costituito da due parti - una parte A che deve essere eseguita da un singolo core di calcolo e una parte B che può essere parallelizzata - possiamo notare che aggiungere nuovi core al sistema di calcolo produce un beneficio limitato. L'aggiunta potenzia di molto la velocità di esecuzione della parte B - ma la velocità di esecuzione della parte A resterà la stessa. + +Il diagramma sotto riportato illustra gli andamenti nel tempo della velocità di esecuzione in alcuni casi: + +![Diagram: Amdahl's Law](./images/amdahls_law.png) + +*(Crediti Immagine: Daniels220 su Wikipedia in lingua inglese, Creative Commons Attribution-Share Alike 3.0 Unported, https://en.wikipedia.org/wiki/File:AmdahlsLaw.svg)* + +Come si può vedere, anche un programma che è al 50% parallelizzabile beneficerà molto poco dell'aggiunta di più di 10 core di calcolo, mentre un programma che è parallelizzabile al 95% può raggiungere speedup significativi nella velocità di esecuzione anche oltre 1000 core di calcolo aggiunti. + +Dal momento che [la legge di Moore](#legge-di-moore) sta rallentando, e l'aumento della velocità dei singoli core di calcolo diminuisce, parallelizzare diventa la chiave per migliorare le performance. Un eccellente esempio è la grafica computerizzata: con i moderni Shader, è possibile renderizzare in parallelo pixel e frammenti - questo è il motivo per cui le schede grafiche hanno migliaia di core di calcolo (GPU o Shader Unit) + +Vedi anche: + +- [Legge di Brooks](#legge-di-brooks) +- [Legge di Moore](#legge-di-moore) + +### Legge di Brooks + +[Legge di Brooks su Wikipedia](https://it.wikipedia.org/wiki/Legge_di_Brooks) + +> L'aggiunta di risorse umane ad un progetto di sviluppo software già in ritardo lo fa tardare ancora di più. + +Questa legge suggerisce che in molti casi il tentativo di accelerare, tramite aggiunta di ulteriori persone a staff, la delivery di un progetto che è già in ritardo risulterà nell'aumento del ritardo progettuale. Brooks sottolinea che questo scenario è certamente molto semplificato, ma che tuttavia il ragionamento alla base è che il tempo necessario alle nuove risorse per diventare produttive e l'overhead di comunicazione introdotto causano una decrescita della velocità nel breve termine. Inoltre molti task risultano non suddivisibili o facilmente distribuibili tra più risorse, causando un corrispondente minor aumento nella velocità potenziale. + +La famosa frase "Nove donne non fanno un figlio in un solo mese" è relativa alla Legge di Brook, in particolare al fatto che alcuni tipi di operazioni non sono suddivisibili o parallelizzabili. + +Questo è un tema centrale del libro '[The Mythical Man Month](#reading-list)'. + +Vedi anche: + +- [Death March](#todo) +- [Reading List: The Mythical Man Month](#reading-list) + +### Legge di Conway + +[Legge di Conway su Wikipedia](https://it.wikipedia.org/wiki/Legge_di_Conway) + +Questa legge indica che i confini di un sistema software riflettono la struttura dell'organizzazione che lo produce. Comunemente citata quando si parla di miglioramenti organizzativi, la legge di Conway afferma che se un'organizzazione è strutturata in tante piccole unità tra loro disconnesse, il software che essa produrrà avrà la stessa struttura. Se un'organizzazione invece è costruita attorno a "silo" verticali dedicati a funzionalità o servizi, i suoi sistemi software rifletteranno questa caratteristica. + +Vedi anche: + +- [Il modello Spotify](#il-modello-spotify) + +### Numero di Dunbar + +[Numero di Dunbar su Wikipedia](https://it.wikipedia.org/wiki/Numero_di_Dunbar) +"Il numero di Dunbar è stato suggerito come valore cognitivo che limita il numero di persone con cui un individuo riesce a mantenere relazioni sociali stabili - relazioni in cui l'individuo sa chi è ciascuna controparte e come tutte le controparti si relazionano tra di loro". Non c'è concordanza sull'esatto valore di questo limite. "... Dunbar ha affermato che un essere umano può mantenere solo 150 relazioni stabili". Egli ha inserito questa affermazione in un contesto più sociale: "il numero di persone con cui ti sentiresti a tuo agio a prendere un drink se entrassi in un bar e le incontrassi casualmente". Le stime per il numero generalmente stanno tra 100 e 250. + +Come le relazioni stabili tra individui, le relazioni di uno sviluppatore con una codebase necessitano di impegno per essere mantenute. Quando ci troviamo di fronte a progetti grandi e complicati, o abbiamo la responsabilità di molti progetti, ci affidiamo a convenzioni, policy e procedure disegnate per scalare. Il numero di Dunbar non solo è importante da ricordare quando un ufficio cresce di dimensioni, ma anche quando si stabilisce il perimetro per l'operato di un team o quando si deve decidere se investire nella strumentazione per modellizzare e automatizzare l'overhead logistico. Inquadrando il numero di Dunbar in un contesto ingegneristico, esso rappresenta il numero di progetti (o la comoplessità normalizzata di un singolo progetto) sui quali un individuo si sentirebbe sicuro di lavorare a chiamata. + +Vedi anche: + +- [Legge di Conway](#legge-di-conway) + +### Legge di Gall + +[Legge di Gall su Wikipedia](https://en.wikipedia.org/wiki/John_Gall_(author)#Gall's_law) + +> Un sistema di complessità elevata e che funziona è inevitabilmente evoluto a partire da un sistema più semplice che funzionava. Un sistema complesso disegnato da zero non funziona per definizione e non può essere modificato per funzionare: bisogna partire ripartire da un sistema semplice che funziona. +> +> ([John Gall](https://en.wikipedia.org/wiki/John_Gall_(author))) + +La Legge di Gall implica che i tentativi di _disegnare_ un sistema ad alta complessità hanno alta probabilità di fallire. I sistemi complessi raramente sono costruiti in una sola iterazione, al contrario sono il risultato dell'evoluzione di sistemi più semplici. + +Un classico esempio è il World Wide Web. Al suo stato attuale, è un sistema fortemente complesso. Tuttavia, inizialmente fu definito come un sistema semplice per condividere contenuti tra istituti accademici. Realizzò questo obiettivo con grande successo ed mutò nel tempo divenendo sempre più complesso al passare del tempo. + +Vedi anche: + +- [KISS (Keep It Simple, Stupid)](#TODO) + +### Rasoio di Hanlon + +[Rasoio di Hanlon su Wikipedia](https://it.wikipedia.org/wiki/Rasoio_di_Hanlon) + +> Non attribuire mai a malafede quel che si può ragionevolmente spiegare con la stupidità. +> +> Robert J. Hanlon + +Questo principio suggerisce che l'ottenimento di un risultato negativo con ogni probabilità non è dovuto alla volontà perversa di fallire quanto alla mancata comprensione (totale o parziale) dell'impatto delle proprie azioni. + +### Legge di Hofstadter + +[Legge di Hofstadter su Wikipedia](https://it.wikipedia.org/wiki/Legge_di_Hofstadter) + +> Per fare una cosa ci vuole sempre più tempo di quanto si pensi, anche tenendo conto della Legge di Hofstadter. +> +> (Douglas Hofstadter) + +Questa legge è citata quando si fanno le stime sulla durata di qualcosa. Nello campo dello sviluppo software sembra essere un assioma la tendenza ad essere poco bravi nello stimare con precisione quanto tempo verrà richiesto per le delivery. + +La legge viene dal libro '[Gödel, Escher, Bach: An Eternal Golden Braid](#reading-list)'. + +Vedi anche: + +- [Reading List: Gödel, Escher, Bach: An Eternal Golden Braid](#reading-list) + +### Legge di Hutber + +[Legge di Hutber su Wikipedia](https://en.wikipedia.org/wiki/Hutber%27s_law) + +> I miglioramenti spesso celano altri peggioramenti. +> +> ([Patrick Hutber](https://en.wikipedia.org/wiki/Patrick_Hutber)) + +La legge indica che i miglioramenti apportati ad una parte di un sistema porteranno ad un inevitabile deterioramento in altre sue parti, causando quindi un globale deterioramento nello stato corrente del sistema. + +Per esempio, la diminuzione nella latenza di risposta di uno specifico end-point provoca un amumento nel throughput e problemi di capacity nel workflow di gestione delle richieste, impattando altri sottosistemi correlati. + +### Hype Cycle e Legge di Amara + +[Hype Cycle su Wikipedia](https://it.wikipedia.org/wiki/Hype_cycle) + +> Tendiamo a sovrastimare l'impatto di una tecnologia sul breve termine e nel sottostimarlo sul lungo termine. +> +> (Roy Amara) + +L'Hype Cycle è una rappresentazione visuale del clamore attorno allo sviluppo di una tecnologia nel tempo, originariamente ideata da Gartner. Un esempio: + +![The Hype Cycle](./images/gartner_hype_cycle.png) + +*(Crediti Immagine: Jeremykemp su Wikipedia in lingua inglese, CC BY-SA 3.0, https://commons.wikimedia.org/w/index.php?curid=10547051)* + +In sintesi, il Cycle dice che tipicamente esiste un picco di frenesia quando nasce una nuova tecnologia riguardo i suoi potenziali impatti. I team di lavoro di solito adottano velocemente tali tecnologie e a volte si trovano scontenti del risultato. Ciò può essere dovuto all'immaturità della tecnologia, oppure alla mancanza di applicazioni reali significative. Dopo un certo periodo di tempo, le potenzialità della tecnologia aumentano e aumenta il numero delle opportunità concrete che essa offre, per cui i team di lavoro possono finalmente aumentare la loro produttività adottandola. La citazione di Roy Amara riassume in breve questa situazione - "Tendiamo a sovrastimare l'impatto di una tecnologia sul breve termine e nel sottostimarlo sul lungo termine". + +### Legge di Hyrum (Legge delle Interfacce Implicite) + +[Legge di Hyrum Online](http://www.hyrumslaw.com/) + +> Dato un numero sufficientementa elevato di utenti di un'API, +> il contenuto del contratto di interfaccia non conta: +> tutti i comportamenti osservabili del sistema che espone l'API +> saranno utilizzati da questi utenti. +> +> (Hyrum Wright) + +La lagge di Hyrum dice che quando un'API ha un _numero sufficientementa elevato di consumer_, tutti i comportamenti di essa (anche quelli non definiti come parte dell'interfaccia pubblica) prima o poi costituiranno una dipendenza lato consumer. Un esempio banale è quello degli aspetti non-funzionali come il tempo di risposta di un'API. Un esempio più profondo è quello di consumer che applicano una regex sui messaggi di errore dell'API per determinarne la *tipologia*. Anche se il contratto pubblico di interfaccia un'API non dice nulla riguardo al contenuto dei messaggi e suggerisce agli utentil'utilizzo dei codici di errore associati ai messaggi, _alcuni_ utenti possono comunque utilizzare i messaggi di errore a tal fine e dunque una modifica dei messaggi sostanzialmente rompe l'integrazione per questi utenti. + +Vedi anche: + +- [Legge dell'Astrazione Fallata](#legge-dell-astrazione-fallata) +- [XKCD 1172](https://xkcd.com/1172/) + +### Legge di Moore + +[Legge di Moore su Wikipedia](https://it.wikipedia.org/wiki/Legge_di_Moore) + +> Il numero di transistor in un circuito integrato raddoppia approssimativamente ogni due anni. + +Spesso utilizzata per illustrare il tasso con cui le tecnologie a semiconduttori e i chip migliorano nel tempo, la legge di Moore si è dimostrata molto accurata dagli anni Settanta fino alla fine dei Duemila. Più di recente il trend è lievemente cambiato, in parte a causa delle [limitazioni fisiche alla miniaturizzazione delle componenti elettroniche](https://it.wikipedia.org/wiki/Effetto_tunnel) ma tuttavia avanzamenti nel campo della parallelizzazione del calcolo e scoperte potenzialmente rivoluzionarie nel campo delle tecnologie a semiconduttori e nel quantum computing potrebbero portare la legge di Moore a valere anche nei prossimi decenni. + +### Legge di Parkinson + +[Legge di Parkinson su Wikipedia](https://it.wikipedia.org/wiki/La_legge_di_Parkinson) + +> Il lavoro tende ad espandersi fino ad impiegare tutto il tempo disponibile per svolgerlo. + +Nel suo contesto originale, questa legge era riferita agli studi sulla gestione della burocrazia. Può essere applicata in ottica pessimistica alle iniziative di sviluppo software, e in sostanza afferma che i team saranno inefficienti fino all'approssimarsi delle deadline e lavoreranno quindi di corsa per rispettare tali deadline rendendole, in un certo senso, arbitrarie. + +Combinando la legge di Parkinson con la [Legge di Hofstadter](#legge-di-hofstadter), si ottiene una vista ancora più pessimistica: il lavoro tenderà ad espandersi fino ad impiegare tutto il tempo disponibile per svolgerlo e *in ogni caso richiederà più tempo di quanto previsto*. + +Vedi anche: + +- [Legge di Hofstadter](#legge-di-hofstadter) + +### Effetto di Ottimizzazione Prematura + +[Ottimizzazione Prematura su WikiWikiWeb](http://wiki.c2.com/?PrematureOptimization) + +> L'ottimizzazione prematura è la radice di ogni male. +> +> [(Donald Knuth)](https://twitter.com/realdonaldknuth?lang=en) + + +Nella sua pubblicazione [Programmazione Strutturata con clausole Go To](http://wiki.c2.com/?StructuredProgrammingWithGoToStatements), +Donald Knuth scrisse: "I programmatori perdono un'enormità di tempo a preoccuparsi delle performance delle sezioni non critiche dei loro programmi, e i tentativi di efficientarle hanno in realtà un forte impatto negativo durante il debugging e la manutenzione. Dovremmo dimenticarci dei piccoli efficientamenti, che impattano circa il 97% del tempo di esecuzione: **l'ottimizzazione prematura è la radice di ogni male**. Di contro non dovremmo mai lasciarci sfuggire l'occasione di migliorare quel critico 3% del tempo di esecuzione." + +L'_Ottimizzazione Prematura_ può essere definita (in termini meno coloriti) come l'attività di efficientamento fatta prima di avere evidenza della sua necessità. + +### Legge di Putt + +[Legge di Putt su Wikipedia](https://en.wikipedia.org/wiki/Putt%27s_Law_and_the_Successful_Technocrat) + +> Il mondo della tecnologia è dominato da due tipi di persone: coloro che comprendono ciò che non gestiscono e coloro che gestiscono ciò che non comprendono. + +La Legge di Putt è spesso accompagnata dal Corollario di Putt: + +> Ogni gerarchia tecnica, genera un'inversione delle competenze con il passare del tempo. + +Queste frasi suggeriscono che, a causa di svariati criteri di selezione e trend con cui i gruppi di lavoro si organizzano, ci sarà un certo numero di persone di vasta esperienza con ruoli tecnici operativi e un certo numero di ruoli manageriali che non sono in grado di comprendere la complessità e le sfide del contesto lavorativo che sono chiamati a gestire. Ciò si spiega con fenomeni come il [Principio di Peter](#TODO) o [La Legge di Dilbert](#TODO). + +Tuttavia, è corretto specificare che Leggi come queste sono una grande generalizzazione e si applicano ad _alcuni_ tipi di organizzazione e non ad altri. + +Vedi anche: + +- [Principio di Peter](#TODO) +- [Legge di Dilbert](#TODO). + + +### Legge di Conservazione della Complessità (Legge di Tesler) + +[Legge di Conservazione della Complessità su Wikipedia](https://en.wikipedia.org/wiki/Law_of_conservation_of_complexity) + +Le Legge dice che in ogni sistema esiste un certo livello di complessità che non può essere ridotto. + +Parte della complessità di un sistema è introdotta "inavvertitamente" ed è conseguenza della struttura imperfetta, degli errori o semplicemente di una modellizzazione errata del problema da risolvere. La complessità involontaria può essere ridotta (o eliminata). Tuttavia, parte della complessità è "intrinseca" ed è conseguenza della complessità inerente al problema da risolvere. Questa complessità può essere spostata ma non eliminata. + +Un elemento interessante di questa Legge è che ci dice che anche semplificando l'intero sistema, la complessità intrinseca non viene ridotta ma viene _spostata sull'utente_, che deve di conseguenza interagire in modo più sofisticato con il sistema. + + +### Legge dell'Astrazione Fallata + +[La Legge dell'Astrazione Fallata su Joel on Software](https://www.joelonsoftware.com/2002/11/11/the-law-of-leaky-abstractions/) + +> Tutte le astrazioni non banali sono in qualche modo fallate. +> +> ([Joel Spolsky](https://twitter.com/spolsky)) + +Questa legge afferma che le astrazioni generalmente usate in informatica per semplificare l'uso di sistemi complessi, in certe situazioni, lasceranno "trapelare" il dettaglio dei sistemi sottostanti facendo così funzionare l'astrazione in modo inaspettato. + +Un esempio è l'apertura di un file e la lettura del suo contenuto. L'API di un file system è un'_astrazione_ del kernel di sistema, il quale è a sua volta un'astrazione dei processi fisici di modifica dei dati su un disco magnetico (o su una memoria flash nel caso di SSD). Nella maggior parte dei casi, l'astrazione di considerare il file come uno stream di dati binario funzionerà senza problemi. Tuttavia, nel caso di un disco magnetico, la lettura sequenziale dei dati sarà *significativamente* più veloce di un accesso random (per via dell'overhead dovuto ai page fault), ma nel caso di un disco SSD tale overhead non è presente. I dettagli implementativi dell'astrazione dovranno dunque essere compresi se si vuole gestire questo comportamento (ad esempio, i file indice di un database sono strutturati per ridurre l'overhead dell'accesso random), l'astrazione "fallata" lascerà trapelare questi dettagli che possono essere di interesse per il programmatore. + +L'esempio di cui sopra può diventare anche più complesso quando vengono introdotte astrazioni _multiple_. Il sistema operativo Linux consente di accedere file attraverso una rete, rappresentandoli localmente come file "normali". Questa astrazione "farà acqua" se la rete verrà interrotta. Se uno sviluppatore trattasse questi file come file "noemali", senza considerare il fatto che possono essere soggetti alla latenza e alle interruzioni della rete, la soluzione sviluppata avrà un baco. + +L'articolo che descrive questa Legge suggerisce che un'eccessiva fiducia nelle astrazioni, combinata con una scarsa comprensione del sistema sottostante, di fatto in alcuni casi _aumenta_ la complessità del problema da risolvere. + +Vedi anche: + +- [Legge di Hyrum (Legge delle Interfacce Implicite)](#legge-di-hyrum-legge-delle-interfacce-implicite) + +Esempi dal mondo reale: + +- [Partenza lenta di Photoshop](https://forums.adobe.com/thread/376152) - problema incontrato nel passato su Photoshop, che a volta impiegava minuti per avviarsi. Sembra che il problema fosse che all'avvio Photoshop leggeva informazioni sulla stampante di default. Tuttavia, se la stampante era una stampante di rete, questa lettura poteva impiegare un tempo molto lungo. L'_astrazione_ per cui la stampante di rete era presentata al sistema esattamente come una stampante locale causava quindi una situazione di estrema lentezza per gli utenti in condizioni di rete lenta. + +### Legge di Irrilevanza + +[Legge di Irrilevanza su Wikipedia](https://en.wikipedia.org/wiki/Law_of_triviality) + +La Legge afferma che i team di lavoro tendono a dedicare molto più tempo e attenzione a dettagli irrilevanti o legati alla cosmesi del lavoro piuttosto che alle questioni serie e sostanziali. + +Il tipico esempio fittizio usato per illustrare la Legge è quello di un comitato incaricato di approvare i piani per un impianto nucleare, che passa più tempo a discutere i dettagli del ripostiglio delle biciclette che a discutere il ben più importante design dell'impianto stesso. Può essere difficile a volte dare il giusto contributo quando si discute di argomenti grandi e complessi senza avere una preparazione o esperienza adeguata in merito. Tuttavia, le persone vogliono in genere mostrarsi attive nel collaborare fornendo input di valore. Da qui la tendenza a concentrarsi troppo sul dettaglio spiccio, che può essere discusso facilmente, ma non ha necessariamente rilevanza. + +L'esempio fittizio ha portato all'utilizzo del termine "ripostiglio delle biciclette" come metafora della perdita di tempo sui dettagli di poca rilevanza. + +### Filosofia Unix + +[La Filosofia Unix su Wikipedia](https://it.wikipedia.org/wiki/Filosofia_Unix) + +La Filosofia Unix predica che le componenti software debbano essere piccole e mirate a implementare bene un solo scopo. Ciò rende più semplice costruire sistemi mediante composizione di unità piccole, semplici e ben definite, piuttosto che mediante composizione di programmi grossi, complessi e multi-purpose. + +Le moderne prassi come le "Architettura a Microservizi" possono essere viste come applicazioni di questa Filosofia, per cui i servizi sono piccoli e focalizzati sul fare una cosa specifica, consentendo la creazione di comportamenti complessi mediante composizione di mattoni più semplici. + +### Il modello Spotify + +[Il modello Spotify su Spotify Labs](https://labs.spotify.com/2014/03/27/spotify-engineering-culture-part-1/) + +Il modello Spotify è un approccio alla strutturazione del lavoro e dell'azienda che è stato reso popolare da Spotify. In questo modello, i team di lavoro sono organizzati attorno alle features invece che alle tecnologie. + +Il modello Spotify rende inoltre popolari i concetti di Tribù, Gilda, Capitolo, che sono altre componenti della struttura organizzativa. + + +### Legge di Wadler + +[Legge di Wadler su wiki.haskell.org](https://wiki.haskell.org/Wadler's_Law) + +> Nella progettazione di qualsiasi linguaggio, il tempo totale impiegato a discutere un elemento di questa lista è proporzionale a 2 elevato alla potenza corrispondente alla posizione dell'elemento: +> +> 0. Semantica +> 1. Sintassi +> 2. Sintassi lessicale +> 3. Sintassi lessicale dei commenti +> +> (In breve: per ogni ora spesa a discutere della semantica, 8 ore saranno spese sulla sintassi dei commenti). + +Similmente alla [Legge di Irrilevanza](#legge-di-irrilevanza), la Legge di Wadler afferma che nel design di un linguaggio di programmazione il tempo speso sulla discussione della struttura del linguaggio è sproporzionatamente alto se comparato con l'importanza delle feature discussa. + +Vedi anche: + +- [Legge di Irrilevanza](#legge-di-irrilevanza) + +## Principi + +I Principi sono in generale usabili come linee guida per il design. + + +### Principio di Pareto (regola dell'80-20) + +[Il Principio di Pareto su Wikipedia](https://it.wikipedia.org/wiki/Principio_di_Pareto) + +> Nella vita, la maggior parte delle cose non è distribuita equamente. + +Il Principio di Pareto suggerisce che in alcuni casi, la maggior parte dei risultati è effetto di una minoranza degli input + +- l'80% di un software è scrivibile nel 20% del tempo totale allocato per la sua scrittura (di contro, il 20% del codice, ossia le parti più complicate di esso, impiega l'80% del tempo) +- il 20% dell'effort produce l'80% del risultato +- il 20% del lavoro genera l'80% della revenue +- il 20% dei bachi genera l'80% dei crash +- il 20% delle features soddisfa l'80% degli utenti + +Negli anni Quaranta l'ingegnere Americano-Rumeno Dr.Joseph Juran, che è riconosciuto universalmente come il padre del controllo di qualità, [iniziò ad applicare il Principio di Pareto alla quality assurance](https://en.wikipedia.org/wiki/Joseph_M._Juran) + +Questo Principio è anche noto come: Regola dell'80/20, Legge dei Pochi ma Vitali e il Principio della Scarsità dei Fattori. + +Esempi dal mondo reale: + +- Nel 2002 la Microsoft riferì che sistemando il 20% dei bachi nella lista tra i più segnalati vennero sistemati l'80% degli errori e dei crash correlati su Windows e Office ([Riferimento](https://www.crn.com/news/security/18821726/microsofts-ceo-80-20-rule-applies-to-bugs-not-just-features.htm)). + +### Principio di Robustezza (Legge di Postel) + +[Il Principio di Robustezza su Wikipedia](https://en.wikipedia.org/wiki/Robustness_principle) + +> Siate conservativi nelle vostre azioni, ma liberali in ciò che accettate dagli altri. + +Spesso applicato allo sviluppo di applicazioni lato server, questo principio afferma che ciò viene inviato alle terze parti dovrebbe essere il più contenuto e standard possibile, e di contro si dovrebbe accettare anche input non-standard - fintanto che è processabile - in arrivo dalle terze parti. + +L'obiettivo di questo principio è la costruzione di sistemi robusti in quanto possono gestire input malformato, a patto che l'intento degli input si possa ancora cogliere. Tuttavia l'accettazione di input malformati pone potenziali implicazioni a livello di sicurezza, soprattutto laddove non si testi a fondo l'ingestione di tali input. + +### SOLID + +SOLID è un acronimo: + +* S: [Principio di Singola Responsabilità](#principio-di-singola-responsabilita) +* O: [Principio dell'Open Closed](#principio-dell-open-closed) +* L: [Principio di Sotituzione di Liskov](#principio-di-sostituzione-di-liskov) +* I: [Principio di Segregazione delle Interfacce](#principio-di-segregazione-delle-interfacce) +* D: [Principio di Inversione delle Dipendenze](#principio-di-inversione-delle-dipendenze) + +These are key principles in [Object-Oriented Programming](#todo). Design principles such as these should be able to aid developers build more maintainable systems. + +### Principio di Singola Responsabilità + +[Principio di Singola Responsabilità su Wikipedia](https://it.wikipedia.org/wiki/Principio_di_singola_responsabilit%C3%A0) + +> Ogni modulo o classe dovrebbe avere una sola responsabilità. + +Il primo dei Principi '[SOLID](#solid)'. Afferma che i moduli o le classi software dovrebbero fare una e una sola cosa. In termini più pratici, ciò significa che una piccola modifica ad una feature di un programma dovrebbe richiedere la corrispondente modifica di una sola sua componente. Per esempio, cambiare il modo in cui la complessità di una password viene validata dovrebbe richiedere la modifica di una sola parte del programma. + +In teoria, ciò dovrebbe garantire una maggiore robustezza del codice, con maggiore facilità di modifica. Sapere che un componente da cambiare ha una sola responsabilità ne semplifica grandemente il _testing_. Riprendendo l'esempio fatto prima, la modifica del componente che gestisce la validazione della password dovrebbe impattare solo le features di programma che sono correlate con la complessità della password. Di contro, testare un componente che ha svariate responsabilità diventa molto più difficoltoso. + +Vedi anche: + +- [Object-Oriented Programming](#todo) +- [SOLID](#solid) + +### Principio dell'Open Closed + +[Il Principio dell'Open Closed su Wikipedia](https://it.wikipedia.org/wiki/Principio_aperto/chiuso) + +> Le entità software dovrebbero essere aperte all'estensione ma chiuse alla modifica. + +Il secondo dei Principi '[SOLID](#solid)' afferma che le entità software (classi, moduli, funzioni) dovrebbero incoraggiare la possibilità di _estendere_ il proprio comportamento e scoraggiare la modifica del loro _comportamento esistente_ + +Ad esempio, si prenda un modulo in grado di trasformare un documento Markdown in HTML. Se il modulo può essere esteso per gestire una nuova feature proposta per il Markdown, senza doverne modificare il funzionamento interno, allora può definirsi aperto all'estensione. Se al contrario il modulo _non_ può essere modificato dai consumer nel modo in cui gestisce le feature correnti di Markdown, allora sarebbe _chiuso_ alla modifica. + +Questo Principio è particolarmente rilevante nella programmazione orientata agli oggetti, dove è desiderabile progettare tipi di oggetti facilmente estendibili e il cui comportamento corrente non venga modificato in maniera inaspettata. + +Vedi anche: + +- [Object-Oriented Programming](#todo) +- [SOLID](#solid) + +### Principio di Sotituzione di Liskov + +[Il Principio di Sotituzione di Liskov su Wikipedia](https://it.wikipedia.org/wiki/Principio_di_sostituzione_di_Liskov) + +> Deve essere possibile sostituire l'istanza di un tipo con l'istanza di un suo sottotipo senza rompere il codice. + +Il terzo dei Principi '[SOLID](#solid)' afferma che se un componente software fà affidamento su un tipo, allora deve essere possibile utilizzare dei suoi sottotipi al suo posto senza causare errori né dover conoscere il dettaglio di quale sottotipo si sta utilizzando. + +A titolo di esempio, si immagini di avere un metodo che legge un documento XML da una struttura dati che rappresenta un file. Se il metodo accetta il tipo base 'file' come input, allora qualsiasi tipo derivi da 'file' dovrebbe poter essere utilizzato come input al metodo. Se 'file' supporta la ricerca dalla fine all'inizio e il parser XML usa tale funzione, ma il tipo derivato 'network file' non supporta tale funzione, allora 'network file' violerebbe il Principio. + +Il Principio ha particolare rilevanza nella programmazione orientata agli oggetti, dove le gerarchie di tipo devono essere modellizzate con cautela in modo da non generare confusione negli utilizzatori del codice. + +Vedi anche: + +- [Object-Oriented Programming](#todo) +- [SOLID](#solid) + +### Principio di Segregazione delle Interfacce + +[Il Principio di Segregazione delle Interfacce su Wikipedia](https://it.wikipedia.org/wiki/Principio_di_segregazione_delle_interfacce) + +> Nessun client dovrebbe dipendere da comportamenti che non usa. + +Il quarto dei Principi '[SOLID](#solid)' afferma che i consumer di una componente software non dovrebbero dipendere da funzionalità del componente che non utilizzano. + +Ad esempio, si immagini di avere un metodo che legge un documento XML da una struttura dati che rappresenta un file. Deve limitarsi a leggere i byte e a muoversi avanti/indietro sul file. Se tale metodo deve essere aggiornato perchè una caratteristica della struttura del file cambia in modo scorrelato (es. modifica al modello di permessi di sicurezza sul file), allora il Principio non viene rispettato. Sarebbe meglio a questo punto che il file implementasse un'interfaccia 'seekable-stream' e che il lettore XML la sfruttasse. + +Il Principio ha particolare rilevanza nella programmazione orientata agli oggetti, dove interfacce, gerarchie e tipi astratti sono utilizzati per [minimizzare l'accoppiamento](#todo) tra le diverse componenti software. Il [Duck typing](#todo) è un meccanismo che implementa il Principio attraverso l'eliminazione delle interfacce esplicite. + +Vedi anche: + +- [Object-Oriented Programming](#todo) +- [SOLID](#solid) +- [Duck Typing](#todo) +- [Disaccoppiamento](#todo) + +### Principio di Inversione delle Dipendenze + +[Il Principio di Inversione delle Dipendenze su Wikipedia](https://it.wikipedia.org/wiki/Principio_di_inversione_delle_dipendenze) + +> I moduli di alto livello non dovrebbero dipendere dalle implementazioni di basso livello. + + + + +Il quinto dei Principi '[SOLID](#solid)' afferma che le componenti di alto livello che orchestrano l'esecuzione non dovrebbero conoscere i dettagli delle loro dipendenze. + +Ad esempio, si immagini di avere un programma che legge metadati da un sito web. Si potrebbe pensare che le componenti principali debbano conoscere dell'esistenza di un componente adibito al download del contenuto di una pagina web e anche di un componente in grado di leggere i metadati. Tenendo conto dell'inversione delle dipendenze, il componente principale dipenderebbe solo su un componente astratto in grado di recuperare byte e su un componente astratto in grado di leggere i metadati da uno stram di byte. Il componente principale dunque non dovrebbe sapere nulla di TCP/IP, HTTP, HTML, etc. + +Questo Principio è complesso perchè sembra 'invertire' le dipendenze attese di un sistema (da qui il suo nome). In pratica, ciò significa anche che ci deve essere un componente orchestrante di alto livello per assicurare la corretta implementazione dei tipi astratti sui quali si dipende (eg. nell'esempio di prima, _qualcosa_ deve in ogni caso fornire al componente lettore di metadati un file downloader su HTTP e un lettore di metatag HTML). Questo porta all'uso di pattern come l'[Inversione del Controllo](#todo) e l'[Iniezione delle Dipendenze](#todo). + +Vedi anche: + +- [Object-Oriented Programming](#todo) +- [SOLID](#solid) +- [Inversione del Controllo](#todo) +- [Iniezione delle Dipendenze](#todo) + +### Principio DRY + +[Il Principio DRY su Wikipedia](https://it.wikipedia.org/wiki/Don%27t_repeat_yourself) + +> Ogni elemento di conoscenza deve avere una sola, non ambigua, autorevole rappresentazione all'interno di un sistema. + +DRY è l'acronimo dell'inglese _Don't Repeat Yourself_ (Non Reinventare la Ruota). Questo Principio mira ad aiutare gli sviluppatori a ridurre le duplicazioni nel codice e mantenere le informazioni in un solo punto, e fu citato nel 1999 da Andrew Hunt e Dave Thomas nel libro [The Pragmatic Programmer](https://it.wikipedia.org/wiki/The_Pragmatic_Programmer) + +> Il contrario di DRY è _WET_ (Write Everything Twice or We Enjoy Typing - Scrivi Tutto In Doppio o Adoriamo Scrivere alla Tastiera). + +In pratica, se lo stesso elemento informativo si trova duplicato in due (o più) posti differenti, si può usare DRY per fondere insieme gli elementi in un solo posto e riusarlo laddove serva. + +Vedi anche: + +- [The Pragmatic Programmer](https://it.wikipedia.org/wiki/The_Pragmatic_Programmer) + +### YAGNI + +[YAGNI su Wikipedia](https://it.wikipedia.org/wiki/You_aren%27t_gonna_need_it) + +Si tratta dell'acronimo dell'inglese _**Y**ou **A**ren't **G**onna **N**eed **I**t_ (_Non Ne Avrai Bisogno_) + +> Scrivi una porzione di codice sempre e solo quando ne hai un bisogno reale, e mai quando sai solo prevedere il suo uso futuro. +> +> ([Ron Jeffries](https://twitter.com/RonJeffries)) (co-fondatore dell'eXtreme Programming e autore del libro "Extreme Programming Installed") + +Questo Principio dell'_Extreme Programming_ (XP) afferma che gli sviluppatore dovrebbero implementare solo le funzionalità che sono necessarie sulla base dei requisiti immediati ed evitare la tentazione di predire il futuro implementando funzionalità di cui potrebbero avere bisogno più avanti. + +L'aderenza a questo principio dovrebbe ridurre nella codebase la quantità di codice non utilizato, evitando così di sprecare tempo ed effort per sviluppare funzionalità che non portano valore immediato. + +Vedi anche: + +- [Reading List: Extreme Programming Installed](#reading-list) + + +## Reading List + +Se avete trovato questi concetti interessanti, potrebbero interessarvi anche i seguenti libri. + +- [Extreme Programming Installed - Ron Jeffries, Ann Anderson, Chet Hendrikson](https://www.goodreads.com/en/book/show/67834) - Tratta i principi fondamentali dell'Extreme Programming. +- [The Mythical Man Month - Frederick P. Brooks Jr.](https://www.goodreads.com/book/show/13629.The_Mythical_Man_Month) - Un grande classico sull'ingegneria del software. La [Legge di Brooks](#legge-di-brooks) è un tema centrale del libro. +- [Gödel, Escher, Bach: An Eternal Golden Braid - Douglas R. Hofstadter.](https://www.goodreads.com/book/show/24113.G_del_Escher_Bach) - Questo libro è difficile da classificare. La [Legge di Hofstadter](#legge-di-hofstadter) è presa da qui. + +## TODO + +Salve! Se vi trovate qui è perchè avete cliccato sul link ad un argomento che ancora non è stato trattato, mi dispiace - questa pagina è un cantiere aperto! + +Sentitevi liberi di [Segnalare un Problema](https://github.com/dwmkerr/hacker-laws/issues), richiedere più dettaglio o [Aprire una Pull Request](https://github.com/dwmkerr/hacker-laws/pulls) per proporre la vostra definizione dell'argomento.