PIM-3260 : update examples
PIM-3260 : rework interfaces to typehint locale and scope