Skip to content

Document the need to set log level to be able to see any messages #91

@ricardograca

Description

@ricardograca

It's not obvious why nothing is being logged when using the log helper for the first time, when developing a new application. The documentation here makes it seem like it just works, when in fact it doesn't unless you explicitly set a low enough log level.

The only reference I could find to this issue (after a while trying to figure out if it was me doing something wrong) was the bug reports of people that also couldn't understand why nothing was being logged, and a very vague reference to log levels in this page. The problem with this reference is that it mentions the various log levels, and that it defaults to logging only error mode, but the log helper section doesn't mention that it is outputting messages with the INFO level. Also, if I was a new developer I probably wouldn't be very familiar with the standard error level hierarchy, so it's something that should also be better documented.

BTW, I only stumbled upon the reference to log levels by chance, since I would never have guessed that there was something in the Handlebars configuration that was preventing me from seeing log messages, or that I would need to read something unrelated to "Helpers" to get a helper working as intended.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions