promote first the new api

description

by writing some doc about it. But maybe it's already done.

todo by<not specified>
activity of#9b60c659e2ee [shared data] remove get/set_shared_data api