Skip to content
This repository was archived by the owner on Sep 6, 2025. It is now read-only.

Commit 10c513d

Browse files
Jimskaptquadrifoglio
authored andcommitted
Translation Setup: README.md & TRANSLATION.md
In order to help new translators understand the workflow.
1 parent 4bbc377 commit 10c513d

File tree

2 files changed

+28
-27
lines changed

2 files changed

+28
-27
lines changed

README.md

Lines changed: 12 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,34 @@
1-
# NOTICE ABOUT STATUS
2-
3-
The second edition of The Rust Programming Language is getting ever closer to being printed!
4-
This means we're not able to make large changes to chapters that are in any column to the
5-
right of, and including, the "Frozen" column [on our Project board][proj]. Issues or pull
6-
requests submitted for frozen chapters are welcome but will be closed until we start work
7-
on a third edition. Thank you!
8-
9-
[proj]: https://github.com/rust-lang/book/projects/1
1+
> **This is a fork of [rust-lang/book](https://github.com/rust-lang/book) in order to translate the English (second-edition) book in French.**
2+
>
3+
> Please read the help [TRANSLATE.md](https://github.com/quadrifoglio/rust-book-fr/blob/master/second-edition/TRANSLATING.md) !
104
115
# The Rust Programming Language
126

137
[![Build Status](https://travis-ci.org/rust-lang/book.svg?branch=master)](https://travis-ci.org/rust-lang/book)
148

15-
This repo contains two editions of “The Rust Programming Language”; we
16-
recommend starting with the second edition.
9+
This repo contains two editions of “The Rust Programming Language”.
1710

18-
The second edition is a rewrite that will be printed by No Starch Press,
19-
available around May 2018. Check [the No Starch Page][nostarch] for the latest
20-
information on the release date and how to order.
11+
The second edition is a rewrite that will be printed by NoStarch Press,
12+
available around October 2017.
2113

22-
[nostarch]: https://nostarch.com/rust
14+
[You can read it online][html]; the last few chapters aren't completed yet, but
15+
the first half of the book is much improved from the first edition. We recommend
16+
starting with the second edition.
2317

24-
You can read the book for free online! Please see the book as shipped with the
25-
latest [stable], [beta], or [nightly] Rust releases. Be aware that issues in
26-
those versions may have been fixed in this repository already.
27-
28-
[stable]: https://doc.rust-lang.org/stable/book/second-edition/
29-
[beta]: https://doc.rust-lang.org/beta/book/second-edition/
30-
[nightly]: https://doc.rust-lang.org/nightly/book/second-edition/
18+
[html]: http://rust-lang.github.io/book/
3119

3220
[The first edition is still available to read online][first].
3321

3422
[first]: https://doc.rust-lang.org/book/
3523

36-
3724
## Requirements
3825

39-
Building the book requires [mdBook], ideally the same version that
40-
[rust-lang/rust uses in this file][rust-mdbook]. To get it:
26+
Building the book requires [mdBook] >= v0.0.13. To get it:
4127

4228
[mdBook]: https://github.com/azerupi/mdBook
43-
[rust-mdbook]: https://github.com/rust-lang/rust/blob/master/src/tools/rustbook/Cargo.toml
4429

4530
```bash
46-
$ cargo install mdbook --vers [version-num]
31+
$ cargo install mdbook
4732
```
4833

4934
## Building

second-edition/TRANSLATING.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Translation process
2+
3+
1. Ask for the access rights to the french fork on the [initial issue](https://github.com/rust-lang/book/issues/808).
4+
2. Choose a chapter to work on, from the ["french translations" board](https://github.com/quadrifoglio/rust-book-fr/projects/1). Make sure that the original writers marked it as "frozen", and
5+
that the source is is up to date with the [original version](https://github.com/rust-lang/book).
6+
3. Please create a [branch](https://github.com/quadrifoglio/rust-book-fr/branches) in order to work on your translation.
7+
4. Translate the chapter.
8+
5. When you are satisfied with your translation, and want feedback/help on your work, please open a [PR](https://github.com/quadrifoglio/rust-book-fr/pulls).
9+
10+
When the PR is created, you can ask for a review from the other contributors.
11+
You can also help by taking a look at the opened PRs, do not hesitate to comment or provide corrections.
12+
13+
## Tool suggestions
14+
15+
- [BonPatron](http://bonpatron.com/)
16+
- [DeepL Translator](https://www.deepl.com/translator)

0 commit comments

Comments
 (0)