undefined | Better HN

0 pointstw042y ago0 comments

That’s… not documentation. That’s a CLI helpfile. It’s better than nothing but also what is completely broken with the “move fast and break things” mindset.

0 comments

scrozart2y ago

Sure looks like documentation to me, but I don't need pretty webpages. 'man' is more than sufficient for tools like these.

ClumsyPilot2y ago

How would I ever read this documentation without installing postman? Am I suppose to download and install every tool just to read about how it works?

notatoad2y ago

it's documentation enough to not call it an undocumented feature.

the concern with truly undocumented functionality is that it's not included intentionally: either it's a bug or an experimental feature that could be removed or changed with no notice. a poorly-documented feature, on the other hand, will probably at least get a deprecation notice before it disappears

lolinder2y ago

> it's documentation enough to not call it an undocumented feature.

Which is why I didn't call it that, I called it poorly documented.

j / k navigate · click thread line to collapse