<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>George Fakidis general tech/CS/programming blog</title><link>https://blog.georgefkd.com/</link><description>Recent content on George Fakidis general tech/CS/programming blog</description><generator>Hugo</generator><language>en-us</language><lastBuildDate>Thu, 29 Oct 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://blog.georgefkd.com/index.xml" rel="self" type="application/rss+xml"/><item><title>Comments-Toolkit: A tool and method for handling comments</title><link>https://blog.georgefkd.com/conference-talks/comments-toolkit/</link><pubDate>Thu, 29 Oct 2026 00:00:00 +0000</pubDate><guid>https://blog.georgefkd.com/conference-talks/comments-toolkit/</guid><description>&lt;h2 id="the-problem"&gt;The problem&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;Comments are not uniformly handled within a project.&lt;/li&gt;&#10;&lt;li&gt;Rules for them are arbitrary and not statically enforced.&lt;/li&gt;&#10;&lt;li&gt;Comments consume precious code review time.&lt;/li&gt;&#10;&lt;li&gt;Comments are treated as a second-class citizen compared to code.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;Arguments from both sides of the debate:&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;No comments&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Comments&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Code should be self-explanatory.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Prose can express a wider variety of concepts.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Maintenance burden&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Onboarding can be easier.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Redundancy&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Present limitations can be documented.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Compiler can check code&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Domain knowledge is shared.&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;h2 id="the-solution-comments-toolkit"&gt;The solution: Comments-Toolkit&lt;/h2&gt;&#10;&lt;p&gt;Arguing about no-comments vs. comments is like arguing about tabs vs. spaces. We solved that debate with tooling years ago: we use it in editors, configure projects with it, and we barely talk about it anymore. Instead of wasting time on conventions, we relied on tooling.&lt;/p&gt;</description></item><item><title>The Software Abstraction Ouroboros</title><link>https://blog.georgefkd.com/blog/software-abstraction-ouroboros/</link><pubDate>Mon, 05 Oct 2026 12:38:40 +0300</pubDate><guid>https://blog.georgefkd.com/blog/software-abstraction-ouroboros/</guid><description>&lt;h3 id="what-is-abstraction"&gt;What is abstraction&lt;/h3&gt;&#10;&lt;h3 id="climbing-the-ladder-of-abstraction"&gt;Climbing the ladder of abstraction&lt;/h3&gt;</description></item></channel></rss>