Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[MS15] Documentation revamp 2/5 #2539

Closed
vy opened this issue Apr 29, 2024 · 0 comments
Closed

[MS15] Documentation revamp 2/5 #2539

vy opened this issue Apr 29, 2024 · 0 comments
Assignees
Labels
documentation Pull requests or issues that affect documentation STF-Milestones Milestones funded by the Sovereign Tech Fund

Comments

@vy
Copy link
Member

vy commented Apr 29, 2024

This is the 2nd, after #2538, of the 5 STF milestones planned to revamp the website and manual.

Deliverable 1: Documentation

As the core deliverable of this STF milestone, we have implemented several documentation improvements:

But probably the best way to view them is to see them in action:

Deliverable 2: Log4j Tools 0.9.0

While working on the documentation, we encountered certain issues that required a fix in our infrastructure tooling. We addressed these in Log4j Tools 0.9.0 release. Related tickets from this release are as follows:

Log4j Docgen XSD generator bug

Thanks to our work in MS9 (#1954), we automatically generate an XSD to assist users while configuring their log4j2.xml. Coupled with IDEs' XSD assistance, writing Log4j configuration (i.e., log4j2.xml) has become a breeze. While adding/updating documentation, we explicitly use XSD in every log4j2.xml we share. This not only helps us to validate our own examples, but also enables users to safely copy-paste them, and continue editing with XSD assistance. Though we encountered a small bug in the XSD generator: apache/logging-log4j-tools#117 We fixed this in apache/logging-log4j-tools#120 and re-generated the public XSD.

Add skip parameter to Maven goals

There are several Log4j modules which use the Log4j plugin system. Though some are for testing purposes and should not be reflected in the generated XSD, documentation, etc. That is, Log4j Docgen should discard those modules. To accommodate this need, we added skip configuration knobs to all Maven goals: apache/logging-log4j-tools#121

Support multiple template files

In its current form, the Log4j plugin reference is pretty massive. To experiment with breaking this into multiple pages, we enhanced Log4j Docgen Maven Plugin to support multiple template files: apache/logging-log4j-tools#122

@vy vy added documentation Pull requests or issues that affect documentation STF-Milestones Milestones funded by the Sovereign Tech Fund labels Apr 29, 2024
@vy vy self-assigned this Apr 29, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Pull requests or issues that affect documentation STF-Milestones Milestones funded by the Sovereign Tech Fund
Projects
None yet
Development

No branches or pull requests

2 participants