Jason Sachs created SLF4J-392: --------------------------------- Summary: Comment on level ordering in the Logger javadoc Key: SLF4J-392 URL: https://jira.qos.ch/browse/SLF4J-392 Project: SLF4J Issue Type: Improvement Components: Core API Affects Versions: 1.7.22 Reporter: Jason Sachs Assignee: SLF4J developers list Priority: Minor This may be a stupid question, but the {{Logger [javadocs|https://www.slf4j.org/api/org/slf4j/Logger.html] merely say that }} ---- {{*[debug|https://www.slf4j.org/api/org/slf4j/Logger.html#debug(org.slf4j.Marker, java.lang.String)]*([Marker|https://www.slf4j.org/api/org/slf4j/Marker.html] marker, [String|http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html?is-external=tr...] msg)}} Log a message with the specific Marker at the DEBUG level. {{*[error|https://www.slf4j.org/api/org/slf4j/Logger.html#error(org.slf4j.Marker, java.lang.String)]*([Marker|https://www.slf4j.org/api/org/slf4j/Marker.html] marker, [String|http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html?is-external=tr...] msg)}} Log a message with the specific Marker at the ERROR level. {{*[info|https://www.slf4j.org/api/org/slf4j/Logger.html#info(org.slf4j.Marker, java.lang.String)]*([Marker|https://www.slf4j.org/api/org/slf4j/Marker.html] marker, [String|http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html?is-external=tr...] msg)}} Log a message with the specific Marker at the INFO level. {{*[trace|https://www.slf4j.org/api/org/slf4j/Logger.html#trace(org.slf4j.Marker, java.lang.String)]*([Marker|https://www.slf4j.org/api/org/slf4j/Marker.html] marker, [String|http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html?is-external=tr...] msg)}} Log a message with the specific Marker at the TRACE level. {{*[warn|https://www.slf4j.org/api/org/slf4j/Logger.html#warn(org.slf4j.Marker, java.lang.String)]*([Marker|https://www.slf4j.org/api/org/slf4j/Marker.html] marker, [String|http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html?is-external=tr...] msg)}} Log a message with the specific Marker at the WARN level. ---- with no guidance on the relative levels of DEBUG, ERROR, INFO, TRACE, WARN. I presume that SLF4J merely passes these along to a supported framework, which must include at least these levels, and it is up to the framework to dictate the relative ordering? Or do you assume that all frameworks treat ERROR > WARN > INFO > DEBUG > TRACE ? Either way, it would be helpful to include at least one sentence stating this, or referring to the FAQ where the issue can be mentioned, similar to https://www.slf4j.org/faq.html#trace -- This message was sent by Atlassian JIRA (v7.3.1#73012)