comprehensive-rust icon indicating copy to clipboard operation
comprehensive-rust copied to clipboard

Worth keeping android/interoperability/cpp.html and chromium/interoperability-with-cpp.html in sync?

Open anforowicz opened this issue 2 years ago • 5 comments

Android-specific and Chromium-specific parts of the course both talk about using https://cxx.rs for C++/Rust interop. Is it worth it to somehow unify some of the content?

In particular, both introductory slides (at android/interoperability/cpp.html and chromium/interoperability-with-cpp.html) have a diagram of how cxx works, but Chromium also has additional speaker notes where it lists some benefits (over manually authoring the bindings).

PS. Some of the content will need to remain Android-specific and/or Chromium-specific:

/cc @adetaylor

anforowicz avatar Nov 29 '23 23:11 anforowicz

Great that you're on top of this!

I agree that there will be

  • Android specific parts
  • Chromium specific parts
  • and there will also be generic parts

I've been thinking of pulling all of the "Interoperate with X" slides out of the Android section and putting them into their own top-level place for a while. They're a bit out of place there, honestly.

Now, the question is how we can do this? I don't like duplicating the slides, but I think this approach could work:

  • Android has a single slide which says Now to [here](../interoperability/cxx.md) to talk about CXX.
  • Chromium has the same slide.
  • at the end of the generic CXX slides, there will be a slide saying Now go back to [Android](../android.md) or [Chromium](../chromium.md).

I think this could work reasonably well — it will be like those Choose Your Own Adventure books I remember from when I was a child :smile: An important advantage of this is that the mdbook search will point you to the right place since the generic content is only present once.

The Android/Chromium slide could have the part about build rules before after the link to the generic CXX slides.

/cc @randomPoison and @fw-immunant

mgeisler avatar Nov 30 '23 13:11 mgeisler

We could consider putting that after the unsafe section of the Fundamentals course. I've left a fair bit of time for that section, but after some experience teaching the course maybe there's room?

djmitche avatar Nov 30 '23 14:11 djmitche