Hacker News new | ask | show | jobs
by daanvd 1791 days ago
> a three-ring binder called the Prompt File, stuffed with printouts of the dozens of tables in the system, and religiously updated anytime anyone changed anything of significance.

Hey, at least they had documentation.

3 comments

I learned to program on programmable calculators. I don't think I have ever reached the ratio of documentation to code that I've had back then.

Necessity is the mother of documentation.

Pretty hard to write self documenting code when all you have are single letter variables and the language doesn’t support comments.
Letter variables? Luxury! One of the calculator had ops like STO, RCL, PAU, GTO, GSB and some numbered "cells", where you could store the result of the calculation.

The other had ops like '74' which were coordinates of the key which activated the given function.

Getting the full screen of the ZX Spectrum surely spoiled me :)

Yeah, that's why math doesn't have self-documenting theorems, right?
Does maths have self-documenting theorems? O.o
Geometrical proofs could be construed as such, even with some propositional logic given that someone comes up with a solid, universal way of expressing it (cf. The Golden Record)
I’d probably have a parallel file with comments.
And a backup.
Well, as a DBA, I periodically use a 3rd party tool to print out the schema. It's mainly for new hires to learn from.

But sometimes I'll flip through it and notice:

- mis-spelled table names, usually duplicate tables

- missing FKs

- missing unique keys, most commonly for early RoR apps

- developer-specific EAV tables with 1 row.

The benefit always outweighs the dead trees, but printing once a year is typical. Back in the day, more frequenctly on 25-line terminals where there was too much scrolling.

I don't get why this post got into [dead]. Anybody care to explain their reasoning?
User redis_mlc has been shadowbanned for eight months which is an abhorrent practice. He is a prolific contributor, but most readers will never see his comments. Occasionally, a reader with showdead:yes in the options and sufficient karma will "vouch" a post back into general visibility.

Note that the verdict by HN moderator dang talks of a regular ban: https://news.ycombinator.com/item?id=25011268

Reply to redis_mlc <https://news.ycombinator.com/item?id=27878748>, post out of order because of the ban:

Moderation does not care about right or wrong, truthful or fake, moral or immoral.

Moderation cares about harmonic or controversial. There isn't even a "group think", as that would imply direction and consistency.

The user got shadowbanned (apparently automatically).