News for hackers. Stuff that matters.
Re:Ask HN: What is the one thing you would change about docu... by politelemon on Sunday September 17, 2023 @04:24AM (#37542763)
Fewer emojis, preferably zero. They don't help with readability. No need to get cutesy with the "made with love" phrases either.

Documentation should be a simple boring set of pages, it's not a place for designers to practice new designs, frameworks, or navigation techniques.

Screenshots should focus on the content, not what it looks like on a specific device or window decorations. Screenshots are hard work though because they need to be kept up to date.

Please share some of the feedback you received from your other teams

There are no comments on this comment yet.