Re: [PATCH v3 14/19] docs: add Rust documentation

From: Jonathan Corbet
Date: Tue Jan 18 2022 - 17:33:22 EST


Miguel Ojeda <ojeda@xxxxxxxxxx> writes:

> Most of the documentation for Rust is written within the source code
> itself, as it is idiomatic for Rust projects. This applies to both
> the shared infrastructure at `rust/` as well as any other Rust module
> (e.g. drivers) written across the kernel.
>
> However, these documents contain general information that does not
> fit particularly well in the source code, like the Quick Start guide.
>
> It also contains a few binary assets used for the `rustdoc` target
> and a few other small changes elsewhere in the documentation folder.

Glad to see documentation!

That said, I have one little request...

> Documentation/doc-guide/kernel-doc.rst | 3 +
> Documentation/index.rst | 1 +
> Documentation/kbuild/kbuild.rst | 4 +
> Documentation/process/changes.rst | 42 ++++
> Documentation/rust/arch-support.rst | 35 +++
> Documentation/rust/assets/favicon-16x16.png | Bin 0 -> 798 bytes
> Documentation/rust/assets/favicon-32x32.png | Bin 0 -> 2076 bytes
> Documentation/rust/assets/rust-logo.png | Bin 0 -> 53976 bytes

We have really tried to keep binary files (like PNG images) out of the
documentation tree. If we really need these images, can they be
provided in SVG form?

Thanks,

jon