doc: add some examples and documentation of the core use case (RhBug:1138096)