5 ms·
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.
by tw04 3y 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.
- notatoad 3y agoit'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
- lolinder 3y 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.
- scrozart 3y agoSure looks like documentation to me, but I don't need pretty webpages. 'man' is more than sufficient for tools like these.
- ClumsyPilot 3y agoHow 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?