dammIT

A rantbox

#dev Articles


The ineffectiveness of lonely icons

If your target audience is a general population, you should not be using icons alone to convey anything meaningful. By doing so, you have made assumptions that are unlikely to be appropriate to a general audience. You should not assume icons or UI elements are known to your users, as …

architecture.md

If you maintain an open-source project in the range of 10k-200k lines of code, I strongly encourage you to add an ARCHITECTURE document next to README and CONTRIBUTING. Before going into the details of why and how, I want to emphasize that this is not another “docs are good, write …


A question about statically generated websites

When I made a remark that my commenting system is working again, a reader asked a simple enough question: how does one build a site like this? I realised there is no simple answer to this. Well, there is, but it takes a bunch of knowledge (and skills) one has …

isso comments are up again

Commenting had been broken since the 19th of December because of the host having upgraded to Python 3.9 and isso breaking. I tried installing it anew from pip, but there is still a really old version on there; installing it as egg directly from its Git repository1 kind …

YouCompleteMe requiring a rather new vim

If you are even remotely using the same workflows as me, you will be using vim quite a bunch, and not limited to one machine with a given operating system. You might also have taken a liking to YouCompleteMe to serve as the code/word completion solution of choice. The …


COVID-19: day 3 of working from home

We live in interesting times. Countries are in a situation they have not been for multiple decades, if at all. Lots of people will not even remember the last time a situation like this happened. Our prime minister had a historic speech on television (a good one, in my opinion …

Second brain part 1

After the bootstrap post of this series, I investigated quite some tools, and started building my initial framework of tools, just to play with the idea. Like mentioned, I used the mdnav vim plugin to make jumping between note files frictionless. I added some more patches to it, so it …
article header image

Second brain part 0

I have been thinking lately about how I organise my thoughts, notes, files, todo's, incoming messages, and much more. This was partly fed by Ryan Rix and his quest for the ultimate way of organising data, be it org-mode or a variant, TiddlyWiki, or something entirely self-built. I have quite …
article header image

Holiday vim tweaking

Some people binge-watch series when taking some time off, some read books, some enjoy comics, some take time off from computers for a bit, and some spend some hours cleaning up their vim configuration file. This holiday, I did all of the above. Yesterday, instead of spending one day gaming …
article header image

NS API 2019 edition

I just merged a new version of my trusty old NS API Python library. Last year I would have thought to not be touching it for quite a while, as nowadays I'm in the luxurious position of being able to bike to work and not wanting to do basically a …

dammIT alchemy

Today I've been busy with a family party and with a total restyle of this weblog based on Pelican Alchemy Bootstrap 4 and the Bootswatch Lux theme, with my own twist in dark-ish grey. Currently it is generating from my own fork with isso comment support and article images. Breakage …

Help hunt bugs, do not just report them

Today I came across the forum post Don’t report bugs, contribute to bugs hunting about more directly helping (open source) developers help you. Developers really try to write working solutions and like Aurélien Pierre notes: We are the developers. That means we can guarantee you that the software works …

Receive Sentry messages as Telegram notifications

To be able to receive Sentry notifications on Telegram (without using the plugin which only works in the self-hosted Sentry server), one can use webhooks. As I have webhaak to ducttape together webhook all the things, I created a script to send messages to our dev chat, filtering away some …

webhaak all the things

If you're not using webhooks yet to automate things from automatically generating documentation, running tests, updating websites and web applications based on events, please go read up on them. In the meanwhile, I've basically hooked up all my personal projects based on webhooks in GitHub and gitea, powered by my …
article header image

Git-based versioning

So you have this (web) application and you are growing a bit tired of having to manually bump the version number it tells to its users. Also, you would like to see if you are using an up-to-date edition of said app. Enter your Git repository. When you are running …

isso commenting system in a subdirectory on nginx

I very recently moved this weblog to a new host, and in the process finally changed from Apache running mod_wsgi to nginx with uWSGI and supervisor (well, at least for the Python based web apps, as dammIT is a flat site). I'm using isso as commenting system, which runs as …

Andromeda, Substratum and a Chromebook

Andromeda is a way to theme an Android device with Substratum without needing root. You need adb though, so a desktop or laptop computer is needed to initiate the connection between the Andromeda app and Substratum. On regular machines this is not much of an issue, but Chromebooks are both …

diskspacealarm.py

Because it's Friday, I was bitten by a filled-up volume on my VPS again, because Prometheus somehow is randomly crashing my VPS, and because I like thinkering and Python, I wrote a little notification script. Yes, it checks for available disk space on your nodes, with configuration per hostname (it's …