doc: add some examples and documentation of the core use case

RhBug:1138096