notes to software documentation writers

[dmitriizhirov]

DON'T write documentation that says the web application I've just installed can be found on port 8080 if the config file defaults to broadcasting it on port 8888

Comments

[summers_place]

Heh. I hear you on stupid stuff. And fonts... urgh, I really need to start drinking whatever some of their designers must have been drinking when they came up with them.

Here, have a video that may make you laugh: If Fonts Were People

[eriknoble]

"It's not that I'm not a people person. It's that I'm not a stupid people person."

[dmitriizhirov]

Damn, if that's not already on a t-shirt, it needs to be...

[eriknoble]

http://t-shirts.cafepress.com/design/21981113