Wieder was gelernt

Illusion of linearity

2022-03-13 (Sunday)
Tags: documentation

Principle 1: Let users switch between macro and micro views: However, part of the technique of documentation is to create the illusion of a linearity. Linear processes are easier to follow. Our brains are wired for linearity and have difficulty making sense of non-linear systems. As such, even if a process isn’t strictly linear, I look for ways to depict a linear map to simplify the task (assuming the linearity I portray doesn’t negatively mislead the user or distort the system).

Legacycode

2021-03-12 (Friday)
Tags: documentation programming

Fefe’s talk at 36C3 O++ # No explicit license yet, but ... S++ # The source code is public and you can change it I++ # I have done this multiple times before. I know what I'm doing (but do you know what I'm doing?) C # I'm the only user I know about. E # Well, mostly. And the remaining case is simple M+ # For now. I may think of new features in the future V+ # Well, the updates aren't regular, but they shouldn't break anything !

The Documentation System

2020-09-05 (Saturday)
Tags: documentation

https://documentation.divio.com/