Messages in this thread | | | From | Miguel Ojeda <> | Date | Thu, 9 Dec 2021 00:07:24 +0100 | Subject | Re: [PATCH 14/19] docs: add Rust documentation |
| |
On Wed, Dec 8, 2021 at 2:30 AM Nick Desaulniers <ndesaulniers@google.com> wrote: > > I'm sure Documentation/rust/ will grow over time; there's certainly > more that can be added and core kernel devs will have more questions
Indeed -- the comment is only trying to emphasize (or explain) that this might be a difference with respect to C, i.e. that we should try to put as much of the documentation as possible closer to the code, rather than create "far" files in `Documentation/rust`. I will try to clarify the comment.
> But I read through all that was added here and didn't find anything > problematic IMO. I didn't verify the png's are actually the logo...
Thanks for reading through all of it!
> I don't think `make htmldocs` produced any new warnings, though it's > not exactly warning free at the moment (pre-existing before this > series).
Yeah, I also run `make htmldocs` before submitting the patch series rounds. And indeed, there are quite a few warnings (20+?), but none coming from `Documentation/rust` that I could see.
> How is rust-logo.png being included in the docs? Is there something > with RST that isn't grep'able for rust-logo.png?
At the moment, the assets are simply copied to the output folder, in the `rust/Makefile`. (I should provide an SVG too or remove the reference to it, by the way).
Cheers, Miguel
| |