brson/rust-anthology

Chapter editing

Closed this issue · 0 comments

brson commented

Once chapters are preliminarily added to the anthology, we can begin editing them. It's not clear exactly how this will play out, but every chapter will need at least one pass by one editor, and it's likely that we'll need to iterate for a while on some.

If you would like to edit a chapter, mention it in this issue and it will be assigned to you. You will be responsible for a thorough review, considering all the factors below.

Editing considerations

  • We want to preserve the authors original voice, but should edit for grammar, etc.
  • The technical content needs to be accurate
  • The prose needs to correctly reflect the examples
  • The code should work on stable Rust. There may be cause for exceptions, but we'll need to think about it.
  • The markup needs to be consistent across chapters. Any chapters doing something particularly unique with formatting should be considered case-by-case.
  • TODO think about this more

Chapters

  • Understanding Over Guesswork
  • Where Rust Really Shines
  • The Problem With Single-threaded Shared Mutability
  • Fearless Concurrency With Rust
  • Rust's Built-in Traits
  • Finding Closure in Rust