Skip to content

Commit b21a14b

Browse files
committed
final improvements for wording, active/passive etc
1 parent c8c6c29 commit b21a14b

File tree

3 files changed

+11
-12
lines changed

3 files changed

+11
-12
lines changed

src/site/antora/modules/ROOT/pages/index.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,6 @@ The project is actively maintained by a {logging-services-url}/team-list.html[te
3333
[#features]
3434
== Features
3535
36-
We share below some highlights from Log4j features.
36+
Below, we share some highlights from Log4j features.
3737
3838
include::partial$log4j-features.adoc[]

src/site/antora/modules/ROOT/pages/manual/index.adoc

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,12 +25,11 @@ The project is actively maintained by a {logging-services-url}/team-list.html[te
2525
Logging is an essential part of the software development process.
2626
It provides a way to track the flow of execution in a program, allowing developers
2727
to understand the application's behavior without needing a debugger.
28-
This is particularly useful when trying to track down a bug or understand
29-
why a particular piece of code is running slow.
28+
This is particularly useful when tracking bugs or understanding why a particular code runs slowly.
3029
3130
The original concept for Log4j was conceived in early 1996 when the
3231
E.U. SEMPER project decided to develop its own tracing API.
33-
In 2003, the project was donated to the Apache Software Foundation, becoming Apache Log4j.
32+
In 2003, the project was donated to the Apache Software Foundation, which became Apache Log4j.
3433
3534
Since then, Log4j has seen numerous releases and has become a widely adopted solution.
3635

src/site/antora/modules/ROOT/partials/log4j-features.adoc

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -23,25 +23,25 @@ Log4j bundles a rich set of components to assist various use cases.
2323
* xref:manual/lookups.adoc[Lookups] for accessing system properties, environment variables, log event fields, etc.
2424
2525
API separation::
26-
The API for Log4j (i.e., `log4j-api`) is separate from the implementation (i.e., `log4j-core`) making it clear for application developers which classes and methods they can use while ensuring forward compatibility.
26+
The API for Log4j (i.e., `log4j-api`) is separate from the implementation (i.e., `log4j-core`), making it straightforward for application developers which classes and methods to use while ensuring forward compatibility.
2727
(See xref:manual/api-separation.adoc[API Separation] for details.)
28-
The Log4j API also provides the most feature rich logging facade in the market; support for various `Message` types (`Object`, `Map`, etc.) besides plain `String`, lambda expressions, parametrized logging, markers, levels, diagnostic contexts (aka. MDC/NDC), etc.
28+
The Log4j API also provides the most feature-rich logging facade in the market; support for various `Message` types (such as `Object` or `Map`) besides plain `String`, lambda expressions, parametrized logging, markers, levels, diagnostic contexts (aka. MDC/NDC), etc.
2929
Check out the xref:manual/api.adoc[Java API], {logging-services-url}/log4j/kotlin[Kotlin API], and {logging-services-url}/log4j/scala[Scala API] pages for further information.
3030
3131
No vendor lock-in::
32-
Even though the Log4j API is implemented by the Log4j at its fullest, users can choose to use another logging backend.
33-
This can be achieved by either using another backend implementing the Log4j API, or forwarding Log4j API calls to another logging facade (e.g., SLF4J) and using a backend for that particular facade.
32+
Even though Log4j implements the Log4j API at its fullest, users can use another logging backend.
33+
This can be achieved by either using another backend implementing the Log4j API or forwarding Log4j API calls to another logging facade (e.g., SLF4J) and using a backend for that particular facade.
3434
3535
Reliability::
36-
Log4j is built with strong reliability in mind.
37-
Such that it can automatically reload its configuration upon modification, and it will do so without losing log events while reconfiguration is taking place.
36+
Log4j is built with solid reliability in mind.
37+
It can automatically reload its configuration upon modification and will do so without losing log events while reconfiguration occurs.
3838
3939
Performance::
4040
When configured correctly, Log4j can deliver excelling performance without almost any burden on the Java garbage collector, and it will do so without sacrificing reliability.
4141
This is made possible via an asynchronous logger founded on the https://lmax-exchange.github.io/disruptor/[LMAX Disruptor] technology (having its roots in the demanding industry of financial trading) and the garbage-free features baked at hot paths.
4242
Check out the xref:manual/performance.adoc[Performance] page for details.
4343
4444
Extensibility::
45-
Log4j contains a fully-fledged xref:manual/plugins.adoc[plugin support] that users can leverage to extend its functionality.
46-
You can easily add your own components (layouts, appenders, filters, etc.) or customizing existing ones (e.g., adding new directives to the xref:manual/layouts.adoc#PatternLayout[Pattern] or xref:manual/json-template-layout.adoc#extending[JSON Template Layout]).
45+
Log4j contains a fully-fledged xref:manual/plugins.adoc[plugin support] that users can leverage to extend functionality.
46+
You can easily add your components (layouts, appenders, filters, etc.) or customize existing ones (e.g., adding new directives to the xref:manual/layouts.adoc#PatternLayout[Pattern] or xref:manual/json-template-layout.adoc#extending[JSON Template Layout]).
4747
Check out the xref:manual/extending.adoc[Extending Log4j] page.

0 commit comments

Comments
 (0)