For abstract descriptions of what the code does, sure. But for small things like documenting the purpose of arguments, an IDE should warn about changes that are not reflected in the doc comment (type or a new arg altogether). IntelliJ IDEs are pretty good at that.
Rust for example also warns about code included in the doc comments example section which is invalid.
Rust for example also warns about code included in the doc comments example section which is invalid.