linux-kernel - Re: [PATCH v3] 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: <CANiq72=MnCfj_y_dSPZ4Mwyxq1WnuPmw-FQ0H8THLS6kZ8fNOA@mail.gmail.com>
Date: Tue, 1 Oct 2024 22:10:24 +0200
From: Miguel Ojeda <miguel.ojeda.sandonis@...il.com>
To: Carlos Bilbao <carlos.bilbao.osdev@...il.com>
Cc: corbet@....net, ojeda@...nel.org, dirk.behme@...bosch.com, 
	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 v3] kernel-docs: Add new section for Rust learning materials

On Sun, Sep 22, 2024 at 6:04 PM Carlos Bilbao
<carlos.bilbao.osdev@...il.com> wrote:
>
> +   * Title: **Experiment: Improving the Rust Book**
> +
> +      :Author: Cognitive Engineering Lab at Brown University
> +      :URL: https://rust-book.cs.brown.edu/
> +      :Date: Accessed Sep 22 2024
> +      :Keywords: rust, blog.
> +      :Description: From the website: "The goal of this experiment is to
> +        evaluate and improve the content of the Rust Book to help people
> +        learn Rust more effectively.".

Perhaps this could go closer to the Rust book entry since it is a variant of it.

Or are these sorted in a particular way?

> +   * Title: **Opsem-team** (repository)
> +
> +      :Author: Operational semantics team
> +      :URL: https://github.com/rust-lang/opsem-team/tree/main

Nit: I think you can remove the `/tree/main` part of the URL to simplify.

> +      :Date: Accessed Sep 22 2024

Since these are repositories, and elsewhere you say "rolling version",
should that one have a concrete date, or should some of these ones
have a rolling date too?

One more that I remembered and that we could have here if we have
other videos/podcasts/... is Crust of Rust (and probably the book from
the same author).

In any case, I think it looks good, thanks!

Acked-by: Miguel Ojeda <ojeda@...nel.org>

Cheers,
Miguel