logging-log4j-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Remko Popma (JIRA)" <j...@apache.org>
Subject [jira] [Comment Edited] (LOG4J2-1811) Log4j 2 configuration/usage ergonomics
Date Sun, 12 Feb 2017 06:01:41 GMT

    [ https://issues.apache.org/jira/browse/LOG4J2-1811?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15862663#comment-15862663
] 

Remko Popma edited comment on LOG4J2-1811 at 2/12/17 6:00 AM:
--------------------------------------------------------------

I agree the documentation is very good and certainly thorough. On the other hand, I have seen
comments on StackOverflow indicating that for some users the sheer volume of documentation
is a bit intimidating and makes it potentially harder to find what they are looking for. 

What I have in mind for this ticket is to make small "nudges", changes that make Log4j 2 more
intuitive to use and configure. Hopefully that makes documentation less necessary.


was (Author: remkop@yahoo.com):
I agree our documentation is very good and certainly thorough. On the other hand, I have seen
comments on StackOverflow indicating that for some users the sheer volume of documentation
is a bit intimidating and makes it potentially harder to find what they are looking for. 

What I have in mind for this ticket is to make small "nudges", changes that make Log4j 2 more
intuitive to use and configure. Hopefully that makes documentation less necessary.

> Log4j 2 configuration/usage ergonomics
> --------------------------------------
>
>                 Key: LOG4J2-1811
>                 URL: https://issues.apache.org/jira/browse/LOG4J2-1811
>             Project: Log4j 2
>          Issue Type: Epic
>          Components: Configurators, Core
>            Reporter: Remko Popma
>
> The vast majority of StackOverflow Log4j 2 questions is related to configuration. The
Log4j 2 site offers an extensive manual but apparently many questions remain.
> This ticket aims to make Log4j 2 easier to configure and use. This can take many forms:

> * adding documentation
> * making documentation easier to find
> * detecting and addressing inconsistencies
> * facilitating debugging
> * showing richer error messages that help users diagnose problems
> * ... etc
> I am making this an epic so the effort can span multiple releases and include many big
or small changes.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

---------------------------------------------------------------------
To unsubscribe, e-mail: log4j-dev-unsubscribe@logging.apache.org
For additional commands, e-mail: log4j-dev-help@logging.apache.org


Mime
View raw message