> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/getify/You-Dont-Know-JS/llms.txt
> Use this file to discover all available pages before exploring further.

# Contributing

> Learn about contributing to the You Don't Know JS Yet book series

<Note>
  This book series is now complete, **so we are no longer open to contributions.**
</Note>

## Translations

If you're wanting to translate these books, please keep in mind that any such translations **must be posted to this github repository, free and open, and not monetized.**

Foreign translations are appreciated, but only for the 3 second edition books.

<Warning>
  We will not be accepting any new foreign translations for previous editions.
</Warning>

### Translation Resources

Please check these issues first before starting a translation:

<CardGroup cols={2}>
  <Card title="Foreign Language Translations" icon="language" href="https://github.com/getify/You-Dont-Know-JS/issues?utf8=%E2%9C%93&q=label%3A%22foreign+language+translations%22+">
    Browse existing translation efforts
  </Card>

  <Card title="Translation Guidelines" icon="book" href="https://github.com/getify/You-Dont-Know-JS/issues/9">
    Original translation discussion
  </Card>

  <Card title="Translation Status" icon="list-check" href="https://github.com/getify/You-Dont-Know-JS/issues/900">
    Track translation progress
  </Card>

  <Card title="Latest Updates" icon="circle-info" href="https://github.com/getify/You-Dont-Know-JS/issues/1378">
    Recent translation discussions
  </Card>
</CardGroup>

### Translation Process

To create a foreign language translation, follow these steps:

<Steps>
  <Step title="Fork the Repository">
    Fork the [You Don't Know JS Yet repository](https://github.com/getify/You-Dont-Know-JS) to your own GitHub account.
  </Step>

  <Step title="Create Your Translation">
    Make your translation entirely in your fork. Preferably translate all six books, but at a minimum complete one whole book before proceeding.
  </Step>

  <Step title="Request a Branch">
    File an issue asking for a branch to be made on the main repo, named for your [language's ISO code](http://www.lingoes.net/en/translator/langcode.htm).
  </Step>

  <Step title="Submit a Pull Request">
    Once the branch is created, you can submit a PR to merge your translated work into the dedicated language branch.
  </Step>

  <Step title="Become a Maintainer">
    Once the merge is complete, you will be promoted to a repository maintainer so you can manage any further translation maintenance work on your own branch.
  </Step>
</Steps>

## Reading Experience

Many readers have requested improvements to the reading experience, such as:

* Chapter and section cross-links
* Enhanced navigation features
* Interactive elements

### Why We Don't Accept These Changes

The main purpose of the book repository is to track and manage content for publication (paid-for ebooks and print books). The repository is maintained in the open to provide free and early access to the content, ensuring there is no paywall barrier to learning.

<Info>
  This repository **is not optimized for your reading experience.** The intended **best reading experience** is through the published books (either ebook or print).
</Info>

We encourage you to purchase the published books for the optimal reading experience with professional formatting, navigation, and layout. Books are available on [Leanpub](https://leanpub.com/ydkjsy-get-started) and [Amazon](https://www.amazon.com/dp/B084BNMN7T).

## Editions

The current (and final) edition of the books is the **2nd edition**.

<Warning>
  We **are not accepting any contributions** for these books, no exceptions.
</Warning>

The book series has been in development for over 12 years and is now complete. While we appreciate the community's enthusiasm, the series is closed to further content contributions, including:

* Typo fixes
* Content updates
* Additional examples
* Restructuring suggestions

## Questions and Support

If you have a question about the content, please **search first** before asking.

The books have been around for 12 years, and most questions have already been asked and answered in the [GitHub issues](https://github.com/getify/You-Dont-Know-JS/issues).

<Tip>
  Use GitHub's search functionality to find existing discussions on your topic before creating a new issue.
</Tip>

## Financial Support

While content contributions are closed, you can support the author's work financially:

<CardGroup cols={3}>
  <Card title="GitHub Sponsors" icon="github" href="https://github.com/users/getify/sponsorship">
    Sponsor on GitHub
  </Card>

  <Card title="Patreon" icon="patreon" href="https://www.patreon.com/getify">
    Support on Patreon
  </Card>

  <Card title="PayPal" icon="paypal" href="https://www.paypal.me/getify">
    Donate via PayPal
  </Card>
</CardGroup>

You can also support the work by purchasing the published books through [Leanpub](https://leanpub.com/ydkjsy-get-started) or [Amazon](https://www.amazon.com/dp/B084BNMN7T).