summaryrefslogtreecommitdiff
path: root/posts/2020-12-01-the-guides.html
diff options
context:
space:
mode:
Diffstat (limited to 'posts/2020-12-01-the-guides.html')
-rw-r--r--posts/2020-12-01-the-guides.html117
1 files changed, 117 insertions, 0 deletions
diff --git a/posts/2020-12-01-the-guides.html b/posts/2020-12-01-the-guides.html
new file mode 100644
index 0000000..48e2d79
--- /dev/null
+++ b/posts/2020-12-01-the-guides.html
@@ -0,0 +1,117 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <link rel="stylesheet" href="/includes/stylesheet.css" />
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta
+ property="og:description"
+ content="The World Wide Web pages of Adam Carpenter"
+ />
+ <meta property="og:image" content="https://nextcloud.53hor.net/index.php/s/Nx9e7iHbw4t99wo/preview" />
+ <meta property="og:site_name" content="53hor.net" />
+ <meta property="og:title" content="[The Guides]" />
+ <meta property="og:type" content="website" />
+ <meta property="og:url" content="https://www.53hor.net" />
+ <title>53hornet ➙ [The Guides]</title>
+ </head>
+
+ <body>
+ <nav>
+ <ul>
+ <li>
+ <a href="/">
+ <img src="/includes/icons/home-roof.svg" />
+ Home
+ </a>
+ </li>
+ <li>
+ <a href="/info.html">
+ <img src="/includes/icons/information-variant.svg" />
+ Info
+ </a>
+ </li>
+ <li>
+ <a href="https://git.53hor.net">
+ <img src="/includes/icons/git.svg" />
+ Repos
+ </a>
+ </li>
+ <li>
+ <a href="/hosted.html">
+ <img src="/includes/icons/desktop-tower.svg" />
+ Hosted
+ </a>
+ </li>
+ <li>
+ <a type="application/rss+xml" href="/rss.xml">
+ <img src="/includes/icons/rss.svg" />
+ RSS
+ </a>
+ </li>
+ </ul>
+ </nav>
+
+ <article>
+ <h1>𝔗𝔥𝔢 𝔊𝔲𝔦𝔡𝔢𝔰</h1>
+
+ <p class="description">
+ This is partly satirical and purposefully strange to be humorous. These
+ are my personal rules for software development (and other projects where
+ I get carried away easily).
+ </p>
+
+ <p><em>The Guides.</em> The Guiding Principles.</p>
+
+ <p>
+ They guide you. They will not lead you astray. Obey <em>The Guides</em>.
+ </p>
+
+ <p>
+ You've heard them go by different names. YAGNI. KISS. These are not
+ falsehoods, but they are not <em>The Guides</em>. Seek the wisdom of the
+ guides.
+ </p>
+
+ <blockquote>
+ 𝔗𝔥𝔬𝔲 𝔰𝔥𝔞𝔩𝔱 𝔴𝔯𝔦𝔱𝔢 𝔞𝔰 𝔩𝔦𝔱𝔱𝔩𝔢 𝔠𝔬𝔡𝔢 𝔞𝔰 𝔭𝔬𝔰𝔰𝔦𝔟𝔩𝔢 𝔱𝔬 𝔤𝔢𝔱 𝔱𝔥𝔢 𝔧𝔬𝔟 𝔡𝔬𝔫𝔢 𝔯𝔦𝔤𝔥𝔱.
+ </blockquote>
+
+ <blockquote>
+ O Guides, may I please just add this one extra feature? It won't take me
+ long and it will be so nice to have later.
+ </blockquote>
+
+ <blockquote>
+ 𝔗𝔥𝔬𝔲 𝔰𝔥𝔞𝔩𝔱 𝔴𝔯𝔦𝔱𝔢 𝖔𝖓𝖑𝖞 𝖙𝖍𝖊 𝖈𝖔𝖉𝖊 𝖓𝖊𝖈𝖊𝖘𝖘𝖆𝖗𝖞 𝔱𝔬 𝔤𝔢𝔱 𝔱𝔥𝔢 𝔧𝔬𝔟 𝔡𝔬𝔫𝔢 𝔯𝔦𝔤𝔥𝔱.
+ </blockquote>
+
+ <blockquote>
+ O Guides, this can't be correct code. I haven't used proper software
+ development patterns, processes, or practices.
+ </blockquote>
+
+ <blockquote>
+ 𝔓𝔞𝔱𝔱𝔢𝔯𝔫𝔰 𝔣𝔬𝔯 𝔱𝔥𝔢 𝔰𝔞𝔨𝔢 𝔬𝔣 𝔭𝔞𝔱𝔱𝔢𝔯𝔫𝔰 𝔞𝔯𝔢 𝔞𝔫𝔱𝔦-𝔭𝔞𝔱𝔱𝔢𝔯𝔫𝔰.
+ </blockquote>
+
+ <blockquote>
+ O Guides, how may I approach this project pragmatically?
+ </blockquote>
+
+ <blockquote>ℌ𝔢𝔢𝔡 𝔱𝔥𝔢𝔰𝔢 𝔯𝔲𝔩𝔢𝔰:</blockquote>
+
+ <ol>
+ <li>
+ You may only write code directly related to the task at hand. Don't
+ get distracted.
+ </li>
+ <li>
+ Once you have working code, make it correct. Once it is correct, make
+ it secure. Once it is secure, make it small. Once it is small, stop.
+ </li>
+ <li>The enemy of good is better.</li>
+ </ol>
+ </article>
+ </body>
+</html>