Filesystem devs should aim to make “badly written” app code “just work” (2009)
&quot;Anybody who wants more complex and subtle filesystem interfaces is just 
crazy. Not only will they never get used, they&#x27;ll definitely not be 
stable.&quot;<p>I think there is a more universal truism here - that &quot;complex and subtle&quot; are sources of pain, problems and headaches.<p>I want to write &quot;cool&quot; and &quot;magical&quot; code as much as the next person, but that&#x27;s the stuff that I look at later WTF because I am no longer in the same state of mind. Clear, simple, straight forward, plain as day are better than anything else.<p>And if you do have to do something &quot;magical&quot; something &quot;odd&quot; or hard to understand for the love of god please leave notes explaining what, why and how you did what you did. And if you are replacing a &quot;clean&quot; and &quot;readable&quot; version leave it there commented out. Sure it is &quot;in the repo&quot; but almost no one ever looks and you are just making it harder for me to figure out the original intent of whatever was there.