annotations: documentation is sphinx friendly.

Signed-off-by: Yoan Blanc <yoan.blanc@cern.ch>
upgrader: documentation is sphinx friendly.

Signed-off-by: Yoan Blanc <yoan.blanc@cern.ch>