rust-lang / rust-lang/book

Audiobook

Open
#2,240 23 comments 7 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Rust
Stars
18.3k
Forks
4.1k
Avg merge
14m
Merged PRs (30d)
1

Description

I looked online and through the issues, and I haven't seen any mention of an Audio-book. I like to listen to books and talks while doing other things that require my eyes, so I naturally want to find audio versions of concepts.

I personally am on my third read through of the book over the past few years, and I believe there would be a lot of value in an audio version of the book and I would be willing to do at least the initial narration.

I believe it could be accomplished by partitioning the audio for each Chapter in a way that could be tied to the changes in the book and altered when the book is changed.

I think having separate audio files for each "paragraph" would reduce the amount of work that would need to be redone The paragraph could be defined simply based on white-space or heading, and the coherency could be maintained by a queue of wording changes.

--Phil

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue does not name a file, test, or entry point to inspect. Start by reviewing how the book is organized and whether its chapter and paragraph structure can support separate audio files; done would require an agreed audiobook format and a maintainable way to keep recordings aligned with wording changes.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.