Passo.uno

What Makes Docs Beautiful? (opens in new tab)

Discussed on Hacker News and Hacker News

Docs are often thought of as a purely functional artifact, a packet of content that, when it works, it’s not remembered at all. Those who consume documentation, however, can tell whether a manual or docs site pleases our mind and senses in ways that others don’t. We know the feeling of a page that lands and the feeling of a page that drags. Now, if we agree that docs can be a product, why not seek to build them in a way that pleases consumers? If docs are the entry point for products, shouldn...

Read the original article
Sign in to keep reading the full article.

Keyboard Shortcuts

Navigation

Next / previous post
j/k
Open post
oorEnter
Preview post
v

Post Actions

Love post
a
Like post
l
Dislike post
d
Undo reaction
u
Save / unsave
s

Recommendations

Add interest / feed
Enter
Not interested
x

Go to

Home
gh
Interests
gi
Feeds
gf
Likes
gl
History
gy
Changelog
gc
Settings
gs
Discover
gb
Search
/

General

Show this help
?
Submit feedback
!
Close modal / unfocus
Esc

Press ? anytime to show this help