With 5.4.6 we deprecate info.magnolia.cms.util.ObservationUtil - instead people should use info.magnolia.observation.WorkspaceEventListenerRegistration.
This is shortly mentioned on Release notes for Magnolia 5.4.6.
The dev ticket MAGNOLIA-6580 also asked to mention it in documentation.

There is a small section in DOCS which mentions the deprecated ObservationUtil - see Configurationmanagement # Observation, i also add a note there, but it is the wrong place to add examples.

Besides that there is the Observation module page, but since 5.4.6 release does not include the observation module, both things, the module and the utility classes (in main) are orthogonal.

We could create a page about observation mentioning both the module and the utility classes with a code example.

Is it correct to say?

• Use the magnolia-module-observation to enable observation by configration
• Use WorkspaceEventListenerRegistration to enable observation programmatically
  ¿