rust-lang / prev.rust-lang.org

The previous Rust website. The current website's code is at https://github.com/rust-lang/www.rust-lang.org.
https://prev.rust-lang.org
Apache License 2.0
151 stars 340 forks source link

One sentence per line #581

Open hoodie opened 8 years ago

hoodie commented 8 years ago

Hi there, I am currently also working on a translation of the website. I see that the markdown is usually formatted to maintain a certain char/line count. I would like to suggest a different formatting (actually for all doc that requires translation) of one sentence (clause) per line. This makes it much easier for translators to keep the translations up to date. What do you think?

yeputons commented 7 years ago

I think it's a good thing to have. We use that in some of our projects and it shows up to be useful not only for translations, but for nicer diffs in version control as well.

One catch, though: I think that capping maximal line length is still a good idea, so one sentence may span several lines.