google / comprehensive-rust

This is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.

Home Page:https://google.github.io/comprehensive-rust/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Timing information enters the translations

mgeisler opened this issue · comments

Hi @djmitche, I noticed in #1974 that the timing information enters the translations. This is in some sense working as intended, but I fear that it creates extra work for the translators.

On Welcome to Day 1, as an example, if we would format

as a table

Page
Welcome 5 minutes
Hello, World 15 minutes
Types and Values 40 minutes
Control Flow Basics 40 minutes

then the page titles would be extracted on their own — and they would match the title we already extract from each page. So it would reuse the translation for the page, which is kind of neat 🙂

I don't have a good idea for how to include the page link like in the current formatting. We include the link in the translatable message, so this would defeat the attempt at unifying the message here with the page title.

The links probably aren't that useful -- they're available in the sidebar as well. We could just omit them.

To be clear, then, the suggestion is to format the schedule as a table rather than a list?

The links probably aren't that useful -- they're available in the sidebar as well. We could just omit them.

Good point!

To be clear, then, the suggestion is to format the schedule as a table rather than a list?

Yeah, it was an idea for how to avoid generating extra translation work: tables are translated cell-by-cell, so if the content of a cell matches an existing heading, there is no extra work for our translators!