anchor.diff:  </dependency>
   ----
   
  -==== Example
  -
  +=== Examples
  +
  +.Example how to use logrecorder
  +[source,kotlin]
  +----
  +package info.novatec.testit.logrecorder.log4j.junit5
  +
  +import info.novatec.testit.logrecorder.api.LogEntry
  +import info.novatec.testit.logrecorder.api.LogLevel
  +import info.novatec.testit.logrecorder.api.LogRecord
  +import info.novatec.testit.logrecorder.logback.junit5.RecordLoggers
  +import org.assertj.core.api.Assertions.assertThat
  +import org.junit.jupiter.api.BeforeEach
  +import org.junit.jupiter.api.Test
  +
  +internal class Log4JRecorderExtensionTest {
  +
  +    private val testServiceA = TestServiceA()
  +
  +    @BeforeEach
  +    fun logSomethingBeforeTest() {
  +        testServiceA.logSomething()
  +    }
  +
  +    @RecordLoggers(TestServiceA::class) // define from which class you want to test log messages
  +    @Test
  +    fun `extension is registered and log messages are recorded`(
  +        log: LogRecord
  +    ) {
  +        assertThat(log.entries).isEmpty()
  +
  +        testServiceA.logSomething()
  +
  +        // check only messages
  +        assertThat(log.messages).containsExactly(
  +            "trace message a",
  +            "debug message a",
  +            "info message a",
  +            "warn message a",
  +            "error message a"
  +        )
  +
  +        // check message and loglevel
  +        // the next examples show how this can be done easier
  +        assertThat(log.entries).containsExactly(
  +            LogEntry(LogRecord.logger(TestServiceA::class), LogLevel.TRACE, "trace message a"),
  +            LogEntry(LogRecord.logger(TestServiceA::class), LogLevel.DEBUG, "debug message a"),
  +            LogEntry(LogRecord.logger(TestServiceA::class), LogLevel.INFO, "info message a"),
  +            LogEntry(LogRecord.logger(TestServiceA::class), LogLevel.WARN, "warn message a"),
  +            LogEntry(LogRecord.logger(TestServiceA::class), LogLevel.ERROR, "error message a")
  +        )
  +    }
  +}
  +
  +----
  +
  +.Example for logrecorder assertions
   [source,kotlin]
   ----
   import info.novatec.testit.logrecorder.api.LogRecord
  
positive.code:     assertThat(log) {
          containsExactly {
              any("trying to do something")
              error(startsWith("something failed with exception:"))
          }
      }
  }
  ----
  
negative.code: </dependency>
  ----
  
  === Log4j
  
  The `logrecorder-log4j` provides everything you need to start recording any link:https://logging.apache.org/log4j/2.x/[Log4j]-based logging activity.
  