salsa: improve documentation

Yaddrequested to merge
yadd/devscripts:salsa-doc into master

Closes: #919402

@mattia: could you review this according to #919402 ?

Merge request reports