Investigate how we can have the CI pipeline complain about warnings in doc code.

[jxs]

Description

Currently it seems that rustdoc doesn't emit warnings for deprecated variables usage, see #3238 (comment).
We should Investigate if and how can we turn on this (and other like unused variables) warnings for code on doc comments.

Are you planning to do it yourself in a pull request?

Yes if required