4 ms·
Please, please do not use screenshots of terminal sessions in documentation, there are so many reasons not to do this, no copy/paste, loss of textual data, hard
by roydivision 3y ago
Please, please do not use screenshots of terminal sessions in documentation, there are so many reasons not to do this, no copy/paste, loss of textual data, harder to update/correct, size of document, etc.
Instead make that little extra effort to use provided formatting in your wiki/blogging/word processing software using a non-proportional font and ideally appropriate syntax highlighting.
Incidentally this also goes for chat and email.
- thaumasiotes 3y ago> there are so many reasons not to do this > no copy/paste That would be a benefit of using screenshots, not a reason not to use them.
- roydivision 3y agoHow so?
- thaumasiotes 3y agoCopying and pasting seriously inhibits learning and tends to directly cause mistakes.
- crispyambulance 3y ago> Incidentally this also goes for chat and email. Oh hell no. I agree with your point for documentation, but when you're trying to communicate something quickly, it's helpful to take a screenshot, apply a red circle and an arrow to point to an issue AS YOU SEE IT in your context. It's fast, direct, and to the point. And if there's need for more info, that can be followed up with in plain or formatted text and/or attachments.
- tjpnz 3y agoThis is especially true of some programming blogs where instead of giving you the code they'll give you a screenshot of the code instead.