• JustEnoughDucks@feddit.nl
    link
    fedilink
    arrow-up
    1
    ·
    6 months ago

    The problem I have with bug reports for things like docker containers (I will just use that example for now) is again documentation… I get that most people make really bad “it broke, fix it now” kind of reports with no detail, but unless you actually dig into and know the code, there is often almost no debugging documentation (github issue templates help with that when the devs make one)

    Where are the logs? If you refuse to use the docker standard of pushing logs through the log api, don’t respect the LOG_LEVEL environment variable, errors are non-descriptive, and don’t provide documentation to where your logs are stored, how the hell can you expect users to provide relevant logs??

    I have run into dozens of pretty big projects that fail with 0 log output and there is 0 log documentation and then the dev auto closes the issue because “not enough logs to help.” The only way to find the logs is to find an old issue where the dev has laid out where the relevant logs are, like WTF? No I am not going to spend an hour looking in every single part of the undocumented directory structure to see if there happen to be logs in there. Use the standard, document your log locations and what they log (no 3ch9qjV7.log is not descriptive enough), or don’t complain about not being able to help without logs.