Remix.run Logo
palata 2 days ago

Very nice read!

This really resonated with me:

> I would skim the documentation for the command to run, or the configuration to enter, only to get error messages in response. Then a period of frantic searching and trial and error would follow. Until I finally got it right. Once it worked, I reread the original documentation and saw that the answers were right there all along. Crystal clear. And yet somehow it did not register the first time. This happened on multiple occasions.

1over137 2 days ago | parent [-]

Everyone is so used to garbage documentation, that they go googling instead, but OpenBSD docs are in fact very good.

palata 2 days ago | parent [-]

Not that I disagree, but in this case that is really not the point of what I quoted.

The point is that often, before you reach some level of understanding, you can read the docs 5 times and not find the answers you are looking for, even though they are there! As soon as you reach the right level of understanding, then the docs are perfect!