Documentation for the `#[kani::should_panic]` attribute

The `#[kani::should_panic]` attribute was implemented in #2315, now we need to add documentation about it. We should take into account the remarks in the RFC (#2272), and consider including it in the section planned in #2208.