Hacker News new | ask | show | jobs
by tw04 883 days ago
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.
2 comments

Sure looks like documentation to me, but I don't need pretty webpages. 'man' is more than sufficient for tools like these.
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?
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

> 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.