baldur
baldur

One reason why I bounce off a lot of projects and services are poor docs. The most common culprit is the author not realising that the reader knows nothing about their project.

Like, most serverside frameworks leave at least one step in how to set up auth completely undocumented

|
Embed
Progress spinner
AngeloStavrow
AngeloStavrow

@baldur In your experience, is that usually the case when the project is still young, or do you see just as many mature project that are poorly documented?

|
Embed
Progress spinner
baldur
baldur

@AngeloStavrow IME mature projects are often worse. Features get added, new configs, etc. but the docs don’t keep up and often become just plain wrong. And node serverside projects seem worse than client-side ones.

I can’t rule out the poss that I’m just unlucky, tho 🙂

|
Embed
Progress spinner
In reply to
AngeloStavrow
AngeloStavrow

@baldur Heh, maybe. It's important to refactor your docs as often as you refactor your code!

|
Embed
Progress spinner