Timeline for How do you present a directory tree in a post? Is it OK to post an image of a UI widget?
Current License: CC BY-SA 4.0
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 |