Re: [PATCH v12 2/3] rust: add dma coherent allocator abstraction.

From: Miguel Ojeda
Date: Mon Feb 24 2025 - 16:40:40 EST


On Mon, Feb 24, 2025 at 9:07 PM Benno Lossin <benno.lossin@xxxxxxxxx> wrote:
>
> I don't think this is good documentation style. I think copy-pasting the
> first line and second paragraph is better.

Yeah, sometimes a bit of duplication is OK.

Now, even if we wanted to do something like this, then at the very
least intra-doc links should be used properly so that people can
actually jump to the right place in the generated ones.

Abdiel: in general, please use intra-doc links everywhere where they
may work -- the patch is missing almost all of them. It helps not just
readers, but also to keep docs in sync with each other, since you will
get diagnostics if `rustdoc` finds broken links.

Thanks!

Cheers,
Miguel