Skip to main content
20 events
when toggle format what by license comment
Sep 11, 2022 at 9:09 comment added philipxy It is text, it should be in the post as text.
Sep 10, 2022 at 18:58 comment added ggorlen @CodeCaster Hmm... seems to me like those questions would go (ideally but rarely) something like Asker: "my fopen failed" / Commenter: "please show your directory tree and state which directory you're running the command from" / A: (shows tree and working directory context for command) / C: "oh, yeah, when you run the command in ./foo the path assumes you're in ./, use ../bar instead" or whatever. Without the tree/directory info there's no way to help. If you don't get the tree, the asker just swears up and down that all the paths are correct. Problems are often not where OP thinks.
Sep 10, 2022 at 18:44 comment added CodeCaster @ggorlen agreed on all of that, but for a "why does my fopen fail" nobody's going to want to see a directory listing, nor is that question ever going to be relevant to anyone ever again, so there's that... Brings me back to the point: which questions need a directory listing (i.e. multiple directories and multiple files) anyway?
Sep 10, 2022 at 18:37 comment added ggorlen @CodeCaster Directories are critical to reproduce "my build or fopen is failing with file not found, why?" In my experience, users are more likely to bungle a screenshot (showing the wrong directories, collapsed directories, lack of path to the root folder, etc) than they are with tree. But if the user has enough experience to automatically reach for tree, their baseline technical sophistication predisposes them to writing a good question anyway. Directory screenshots can be done correctly but are the tool of choice of the can't-be-bothered. I agree that including both can't hurt though.
Sep 10, 2022 at 18:18 comment added CodeCaster @ggorlen all of those are very valid points, but also pertaining to singular paths. As I'm saying in my answer: when do we need to show directory listings anyway? In my experience, when a question is about a directory structure, it's usually more useful to have a screenshot, as more can be inferred from that anyway. A screenshot should be supplementary to a question anyway, making most of those points moot. I'd rather see a screenshot than a large code block.
Sep 10, 2022 at 15:46 comment added ggorlen @Codecaster Accessibility problems for users with screen readers, lack of copy-paste, inability to detect Unicode/invisible characters to verify a path, difficulty reading the text on certain devices, data costs for mobile users, lack of searchability, potential for broken URLs, inability to improve formatting by editors, waste of bandwidth, dark theme all seem to apply.
Sep 10, 2022 at 9:56 comment added CodeCaster @Polygnome "should be" - says who? That's exactly what we're discussing here, you can't pose that as truth without arguments. My arguments for a screenshot are in my answer.
Sep 10, 2022 at 8:57 comment added Polygnome @CodeCaster If the problem is with the UI, then a screenshot of the UI is appropriate. If the problem is with the files and directories, then a screenshot of the UI showing them is not appropriate, but the actual structure should be given as text.
Sep 10, 2022 at 8:40 comment added CodeCaster @ggorlen almost none of that applies to directory listing. The answer also ends with "Images should only be used to illustrate problems that can't be made clear in any other way, such as to provide screenshots of a user interface", which is pretty much on point here.
Sep 10, 2022 at 1:55 comment added ggorlen It's a problem to include it as a screenshot for pretty much all of the reasons in Why should I not upload images of code/data/errors when asking a question?
Sep 9, 2022 at 17:51 comment added philipxy It is content that can be given by text, it should be text.
Sep 9, 2022 at 16:49 comment added T1960CT @user438383 I'd argue the opposite with people posting light mode screenshots burning out my retinas so I can barely read the rest of the post, haha. As you say though, text is correctable and it also defaults to the theme of the reader, not the poster.
Sep 9, 2022 at 16:32 comment added Mark My favorite is when someone posts a picture they took of their screen with a phone. :}}
Sep 9, 2022 at 13:47 comment added user438383 @CodyGray at least text is fixable, usually by adding code fences, esp if they use tree then it should be easy to fix. Bad screenshots are unfixable.
Sep 9, 2022 at 11:13 comment added Karl Knechtel It's nice to be able to copy and paste out of the tree output in order to write answers that use filenames that match the example in the question.
Sep 9, 2022 at 10:35 comment added Peter Mortensen The folder path could be a crucial part of making a search engine query sufficiently specific to return more than false positives.
Sep 9, 2022 at 9:57 comment added Michael Szczesny If you write tests for your solution and the folder structure is part of the problem, it is much easier to have it provided as text.
Sep 9, 2022 at 9:51 comment added Cody Gray Mod But beginners also, in my experience, tend to post horribly unformatted and completely unreadable text, so I don't really see why that's an argument in favor of doing either thing. The important thing is making sure that your post is readable and clear.
Sep 9, 2022 at 9:35 comment added user438383 Because people, often beginners, post horrible screenshots which are low-res / too zoomed in/out with dark mode or in various other ways which make it very hard to read. Formatted text is always formatted text.
Sep 9, 2022 at 9:29 history answered Cody GrayMod CC BY-SA 4.0