linux-kernel - Re: [PATCH] kernel-docs: Add new section for Rust learning materials

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <c91396bf-4ed1-45b4-8a52-68ac1fea2e2d@gmail.com>
Date: Sun, 22 Sep 2024 10:39:40 -0500
From: Carlos Bilbao <carlos.bilbao.osdev@...il.com>
To: Miguel Ojeda <miguel.ojeda.sandonis@...il.com>
Cc: corbet@....net, ojeda@...nel.org, alex.gaynor@...il.com,
 boqun.feng@...il.com, gary@...yguo.net, benno.lossin@...ton.me,
 a.hindborg@...sung.com, aliceryhl@...gle.com, workflows@...r.kernel.org,
 linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org,
 rust-for-linux@...r.kernel.org, bilbao@...edu
Subject: Re: [PATCH] kernel-docs: Add new section for Rust learning materials

Hello Miguel,

On 9/16/24 03:39, Miguel Ojeda wrote:
> On Wed, Sep 11, 2024 at 8:59 PM Carlos Bilbao
> <carlos.bilbao.osdev@...il.com> wrote:
>> Include a new section in the Index of Further Kernel Documentation with
>> resources to learn Rust. Reference it in the Rust index.
> Thanks for this, Carlos! It would be nice to mention that this came
> out of a session of Kangrejos with suggestions from people in the room
> (or who suggested it).


Sure, I'll mention in the v3 commit that this is the product of a survey
among Kangrejos'24 assistants.


>
> Did you rank/filter them in some way? i.e. my plan was to perhaps make
> a poll or something in Zulip and then pick the best ones.


No filter, I thought the more the better. I'd be willing to read reasons
to remove entries if anyone objects to any resource in the future.


>
> A few extra that got mentioned: https://rust-book.cs.brown.edu
> (perhaps could go into the Rust book entry somehow; having said that,
> I am not sure if it is being updated, and it is part of an
> "experiment"), https://newrustacean.com, the reference,
> https://github.com/rust-lang/opsem-team/blob/main/fcps.md...


Will add in v3.


>
>> +    * Name: **Linux Plumbers (LPC) Rust presentations**
> I wonder if listing individual talks may be a bit too much, compared
> to other entries in the file that link to the overall resource.
> Perhaps LPC should be in a different section as a "global" resource,
> perhaps with links to the few latest years' full schedules?


I thought adding each LPC talk as a separate item was too much. But,
adding them at the end of the list, for those who venture deep enough into
the Rust rabbit hole, I think is good. Honestly, we should be doing more to
take advantage of the documentation generated in LPCs.


>
>> +    * Name: **The Rustacean Station Podcast**
> By the way, are these sorted in any particular way?


The rest of the resource index is chronologically sorted. But, for this
heterogeneous collection of blog posts, talks, etc. I didn't see the point
of that. As the project grows, we'll need to categorize Rust resources and
index them for easier access.


>
> Cheers,
> Miguel


Thanks, Carlos