[jira] [Created] (LOG4J2-879) Minor documentation issues with the 2.1 release

[Remko Popma (JIRA)]

Remko Popma created LOG4J2-879:
----------------------------------

Summary: Minor documentation issues with the 2.1 release
Key: LOG4J2-879
URL: https://issues.apache.org/jira/browse/LOG4J2-879
Project: Log4j 2
Issue Type: Improvement
Components: Documentation
Affects Versions: 2.1
Reporter: Remko Popma
Priority: Minor


Minor issues with the site:
* On the Appenders page, the docs for MemoryMappedFileAppender mention "New since 2.1-beta." Should just be 2.1... I missed that.
* The Layouts page does not mention the new GELF layout.
* The left-hand navigation bar for Layouts does not have a link to JSONLayout
* Javadoc is in the Java 6 format (I thought we did something to make it use the nicer looking Java 8 format?)
* The Configuration manual page is wider than normal and displays a horizontal scrollbar.
I suspect this is because in the System Properties table the Default Value org.apache.logging.log4j.jul.ApiLoggerAdapter cannot be wrapped over multiple lines.
* On the Build page, the comment in italics below the title has the same color as links, but it is not a link. Bit confusing.
* (Personal taste perhaps:) On the Runtime Dependencies page, the warnings against combining log4j-slf4j-impl with log4j-to-slf4j have a very light color that makes them a bit hard to read and does not stand out very much. I would prefer a color that contrasts more with the white background. Red bold-face like on the webapp manual page would work for me. :-)
* (Enhancement, not a problem:) The convenience of creating custom log levels in Log4j2 should be mentioned in the About page and the Manual Introduction page as one of the advantages of Log4j 2. (In log4j 1 users had to create a subclass.)


Minor issues with the Manual PDF:
* The Configuration page has a code example for advertisers that exceeds the page width.
* The Configuration page's table with System Properties exceeds the page width.






--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

[Remko Popma (JIRA)]

[ https://issues.apache.org/jira/browse/LOG4J2-879?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Remko Popma updated LOG4J2-879:
-------------------------------
Description:
Minor issues with the site:
* On the Appenders page, the docs for MemoryMappedFileAppender mention "New since 2.1-beta." Should just be 2.1... I missed that.
* The Layouts page does not mention the new GELF layout.
* The left-hand navigation bar for Layouts does not have a link to JSONLayout
* Javadoc is in the Java 6 format (I thought we did something to make it use the nicer looking Java 8 format?)
* The Configuration manual page is wider than normal and displays a horizontal scrollbar.
I suspect this is because in the System Properties table the Default Value org.apache.logging.log4j.jul.ApiLoggerAdapter cannot be wrapped over multiple lines.
* On the Build page, the comment in italics below the title has the same color as links, but it is not a link. Bit confusing.
* (Personal taste perhaps): On the Runtime Dependencies page, the warnings against combining log4j-slf4j-impl with log4j-to-slf4j have a very light color that makes them a bit hard to read and does not stand out very much. I would prefer a color that contrasts more with the white background. Red bold-face like on the webapp manual page would work for me. :-)
* (Enhancement, not a problem): The convenience of creating custom log levels in Log4j2 should be mentioned in the About page and the Manual Introduction page as one of the advantages of Log4j 2. (In log4j 1 users had to create a subclass.)


Minor issues with the Manual PDF:
* The Configuration page has a code example for advertisers that exceeds the page width.
* The Configuration page's table with System Properties exceeds the page width.




was:
Minor issues with the site:
* On the Appenders page, the docs for MemoryMappedFileAppender mention "New since 2.1-beta." Should just be 2.1... I missed that.
* The Layouts page does not mention the new GELF layout.
* The left-hand navigation bar for Layouts does not have a link to JSONLayout
* Javadoc is in the Java 6 format (I thought we did something to make it use the nicer looking Java 8 format?)
* The Configuration manual page is wider than normal and displays a horizontal scrollbar.
I suspect this is because in the System Properties table the Default Value org.apache.logging.log4j.jul.ApiLoggerAdapter cannot be wrapped over multiple lines.
* On the Build page, the comment in italics below the title has the same color as links, but it is not a link. Bit confusing.
* (Personal taste perhaps:) On the Runtime Dependencies page, the warnings against combining log4j-slf4j-impl with log4j-to-slf4j have a very light color that makes them a bit hard to read and does not stand out very much. I would prefer a color that contrasts more with the white background. Red bold-face like on the webapp manual page would work for me. :-)
* (Enhancement, not a problem:) The convenience of creating custom log levels in Log4j2 should be mentioned in the About page and the Manual Introduction page as one of the advantages of Log4j 2. (In log4j 1 users had to create a subclass.)


Minor issues with the Manual PDF:
* The Configuration page has a code example for advertisers that exceeds the page width.
* The Configuration page's table with System Properties exceeds the page width.

Post by Remko Popma (JIRA)
Minor documentation issues with the 2.1 release
-----------------------------------------------
Key: LOG4J2-879
URL: https://issues.apache.org/jira/browse/LOG4J2-879
Project: Log4j 2
Issue Type: Improvement
Components: Documentation
Affects Versions: 2.1
Reporter: Remko Popma
Priority: Minor
* On the Appenders page, the docs for MemoryMappedFileAppender mention "New since 2.1-beta." Should just be 2.1... I missed that.
* The Layouts page does not mention the new GELF layout.
* The left-hand navigation bar for Layouts does not have a link to JSONLayout
* Javadoc is in the Java 6 format (I thought we did something to make it use the nicer looking Java 8 format?)
* The Configuration manual page is wider than normal and displays a horizontal scrollbar.
I suspect this is because in the System Properties table the Default Value org.apache.logging.log4j.jul.ApiLoggerAdapter cannot be wrapped over multiple lines.
* On the Build page, the comment in italics below the title has the same color as links, but it is not a link. Bit confusing.
* (Personal taste perhaps): On the Runtime Dependencies page, the warnings against combining log4j-slf4j-impl with log4j-to-slf4j have a very light color that makes them a bit hard to read and does not stand out very much. I would prefer a color that contrasts more with the white background. Red bold-face like on the webapp manual page would work for me. :-)
* (Enhancement, not a problem): The convenience of creating custom log levels in Log4j2 should be mentioned in the About page and the Manual Introduction page as one of the advantages of Log4j 2. (In log4j 1 users had to create a subclass.)
* The Configuration page has a code example for advertisers that exceeds the page width.
* The Configuration page's table with System Properties exceeds the page width.

--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

[Gary Gregory (JIRA)]

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

Gary Gregory commented on LOG4J2-879:
-------------------------------------

Current status:

Minor issues with the site:

(x) On the Appenders page, the docs for MemoryMappedFileAppender mention "New since 2.1-beta." Should just be 2.1... I missed that.
(x) The Layouts page does not mention the new GELF layout.
(x) The left-hand navigation bar for Layouts does not have a link to JSONLayout
(x) Javadoc is in the Java 6 format (I thought we did something to make it use the nicer looking Java 8 format?)
(x) The Configuration manual page is wider than normal and displays a horizontal scrollbar.
(x) I suspect this is because in the System Properties table the Default Value org.apache.logging.log4j.jul.ApiLoggerAdapter cannot be wrapped over multiple lines.
(x) On the Build page, the comment in italics below the title has the same color as links, but it is not a link. Bit confusing.
(x) (Personal taste perhaps): On the Runtime Dependencies page, the warnings against combining log4j-slf4j-impl with log4j-to-slf4j have a very light color that makes them a bit hard to read and does not stand out very much. I would prefer a color that contrasts more with the white background. Red bold-face like on the webapp manual page would work for me.
(x) (Enhancement, not a problem): The convenience of creating custom log levels in Log4j2 should be mentioned in the About page and the Manual Introduction page as one of the advantages of Log4j 2. (In log4j 1 users had to create a subclass.)

Minor issues with the Manual PDF:

(x) The Configuration page has a code example for advertisers that exceeds the page width.
(x) The Configuration page's table with System Properties exceeds the page width.

Post by Remko Popma (JIRA)
Minor documentation issues with the 2.1 release
-----------------------------------------------
Key: LOG4J2-879
URL: https://issues.apache.org/jira/browse/LOG4J2-879
Project: Log4j 2
Issue Type: Improvement
Components: Documentation
Affects Versions: 2.1
Reporter: Remko Popma
Priority: Minor
* On the Appenders page, the docs for MemoryMappedFileAppender mention "New since 2.1-beta." Should just be 2.1... I missed that.
* The Layouts page does not mention the new GELF layout.
* The left-hand navigation bar for Layouts does not have a link to JSONLayout
* Javadoc is in the Java 6 format (I thought we did something to make it use the nicer looking Java 8 format?)
* The Configuration manual page is wider than normal and displays a horizontal scrollbar.
I suspect this is because in the System Properties table the Default Value org.apache.logging.log4j.jul.ApiLoggerAdapter cannot be wrapped over multiple lines.
* On the Build page, the comment in italics below the title has the same color as links, but it is not a link. Bit confusing.
* (Personal taste perhaps): On the Runtime Dependencies page, the warnings against combining log4j-slf4j-impl with log4j-to-slf4j have a very light color that makes them a bit hard to read and does not stand out very much. I would prefer a color that contrasts more with the white background. Red bold-face like on the webapp manual page would work for me. :-)
* (Enhancement, not a problem): The convenience of creating custom log levels in Log4j2 should be mentioned in the About page and the Manual Introduction page as one of the advantages of Log4j 2. (In log4j 1 users had to create a subclass.)
* The Configuration page has a code example for advertisers that exceeds the page width.
* The Configuration page's table with System Properties exceeds the page width.

--
This message was sent by Atlassian JIRA
(v6.3.4#6332)