summaryrefslogblamecommitdiff
path: root/posts/2020-12-01-the-guides.php
blob: a3629beed8806f5aa5c467967c1cd74d364358b7 (plain) (tree)
































































                                                                                                                                                                                                                                                      
<?php
$title = "𝔗𝔥𝔢 𝔊𝔲𝔦𝔡𝔢𝔰";
if (isset($early) && $early) {
	return;
}
include($_SERVER['DOCUMENT_ROOT'] . '/includes/head.php');
?>

<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>