From f7862cb6b48469c69e5b088d5bbe30109eb6f6b0 Mon Sep 17 00:00:00 2001 From: Harald Pfeiffer Date: Mon, 21 Apr 2025 11:43:17 +0200 Subject: + remark about doc of udpater.phar --- README.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 645ae9a..ec2368a 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ updater.phar is useless. 2. It THEN proceeds to the download which may be hilariously slow (Version 31.x.x: the servers delivered a 255MiB file in over 15 minutes to a machine with download speeds of 30+MiB/sec) so the backup may already be dated when we proceed -3. It then does stuff with nextcloud in an undocumented manner. Given that some utterly stupid +3. It then does stuff with nextcloud in an undocumented [^1] manner. Given that some utterly stupid morons decided that within Nextcloud (nice software) everything needs to be writable by the web server user (utterly insane), we don't want to rely on such a construct too much. (Nextcloud don't give a fuck about security principles that are aaaaages old? Fuck your meta @@ -38,3 +38,11 @@ updater.phar is useless. 5. Make the current verbose output dependent on a CLI option, choose to also offer syslog and scheduler friendly output (i.e. only hard results on output for e.g. systemd timers, and ofc to logger) + +# Footnotes + +[^1]: Well, the code is open. Nonetheless, consider this: the PHP file has 41887(!) lines of code at the + time of writing including some binary code. We had 707 lines overall when this remark was created. + That's a monstrosity. Nobody wants to read that. Plus, it's always good to have documentation at hand + also outlining paradigms of the code. Inside updater.phar, there is _a bit_ of documentation and + zero outlines. (Is the name "humbug" intentional? :-) ) -- cgit v1.2.3