Re: [I] [MS9] Schema and documentation generation from source code (logging-log4j2)

2024-03-19 Thread via GitHub
grobmeier commented on issue #1954: URL: https://github.com/apache/logging-log4j2/issues/1954#issuecomment-2006326517 Looks good to me, thanks for all the hard work! -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the

Re: [I] [MS9] Schema and documentation generation from source code (logging-log4j2)

2024-03-19 Thread via GitHub
grobmeier closed issue #1954: [MS9] Schema and documentation generation from source code URL: https://github.com/apache/logging-log4j2/issues/1954 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the

Re: [I] [MS9] Schema and documentation generation from source code (logging-log4j2)

2024-02-06 Thread via GitHub
ppkarwasz commented on issue #1954: URL: https://github.com/apache/logging-log4j2/issues/1954#issuecomment-1929293548 1. Absolutely. It is easier to output a different Asciidoc document per plugin, but it will probably look better as a single page or a couple of pages. 2. This is due to

Re: [I] [MS9] Schema and documentation generation from source code (logging-log4j2)

2024-02-06 Thread via GitHub
vy commented on issue #1954: URL: https://github.com/apache/logging-log4j2/issues/1954#issuecomment-1929270262 Great work Piotr! :100: :clap: Some remarks: 1. I see many pages are hardly filled. Shall we collapse the entire reference to a single page? WDYT? That is, one page per [Mave

Re: [I] [MS9] Schema and documentation generation from source code (logging-log4j2)

2024-02-06 Thread via GitHub
ppkarwasz commented on issue #1954: URL: https://github.com/apache/logging-log4j2/issues/1954#issuecomment-1929209213 The descriptions are taken from Javadoc comments, which shows us how many Javadoc comments are missing. Also the links in the _descriptions_ (which are taken from `{@

Re: [I] [MS9] Schema and documentation generation from source code (logging-log4j2)

2024-02-06 Thread via GitHub
ppkarwasz commented on issue #1954: URL: https://github.com/apache/logging-log4j2/issues/1954#issuecomment-1929200674 I have published a preview of a documentation generated from real data. Interesting pages: * [Configuration](https://logging.staged.apache.org/log4j/3.x/ref/Core/org

Re: [I] [MS9] Schema and documentation generation from source code (logging-log4j2)

2023-11-22 Thread via GitHub
vy commented on issue #1954: URL: https://github.com/apache/logging-log4j2/issues/1954#issuecomment-1822837910 Note that `XmlSchemaTest` needs to be removed and its functionality should ideally be replaced with a `xml-maven-plugin` validation that can take place at the Maven `validation` p

Re: [I] [MS9] Schema and documentation generation from source code (logging-log4j2)

2023-11-10 Thread via GitHub
ppkarwasz commented on issue #1954: URL: https://github.com/apache/logging-log4j2/issues/1954#issuecomment-1806545825 The plan is to delete all `*.md`, `*.adoc` and other files that describe our components' configuration and put everything into Javadoc. The manual will be split into

Re: [I] [MS9] Schema and documentation generation from source code (logging-log4j2)

2023-11-10 Thread via GitHub
jvz commented on issue #1954: URL: https://github.com/apache/logging-log4j2/issues/1954#issuecomment-1806525088 I think I've proposed something along these lines in the past, but it seemed like too much work at the time. However, I love this idea in general. It would be great if we could e