Skip to content

Commit 57370f2

Browse files
committed
README: updating with new status from 'The Unbooks' ebook being published, closes #1899
1 parent 7e08b21 commit 57370f2

File tree

4 files changed

+41
-20
lines changed

4 files changed

+41
-20
lines changed

.github/ISSUE_TEMPLATE/foreign-translation-request.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ labels:
55

66
---
77

8-
Foreign translations are appreciated. However, any such requests should wait until the 2nd edition is complete.
8+
Foreign translations are appreciated, but only for the 3 second edition books.
99

1010
**I will not be accepting any new foreign translations for previous editions.**
1111

CONTRIBUTING.md

Lines changed: 30 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,31 @@
11
# Contributing
22

3-
Please feel free to contribute to the quality of this content (subject to limitations discussed below) by submitting PR's for improvements to code snippets, explanations, etc. If there's any doubt or if you think that a word/phrase is used confusingly, **before submitting a PR, open an issue to ask about it.**
3+
This book series is now complete, **so in general, we're no longer open to contributions.**
44

5-
However, if you choose to contribute content (not just typo corrections) to this repo, you agree that you're giving me a non-exclusive license to use that content for the book, as I (and my publisher) deem appropriate. You probably guessed that already, but I just wanted to be extra clear on that.
5+
## Translations
6+
7+
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.**
8+
9+
Foreign translations are appreciated, but only for the 3 second edition books.
10+
11+
**I will not be accepting any new foreign translations for previous editions.**
12+
13+
----
14+
15+
Please check these issues first:
16+
17+
* https://github.com/getify/You-Dont-Know-JS/issues?utf8=%E2%9C%93&q=label%3A%22foreign+language+translations%22+
18+
* https://github.com/getify/You-Dont-Know-JS/issues/9
19+
* https://github.com/getify/You-Dont-Know-JS/issues/900
20+
* https://github.com/getify/You-Dont-Know-JS/issues/1378
21+
22+
To summarize, the steps for a foreign language translation are:
23+
24+
1. Fork this repo
25+
2. Make your own translation entirely in your fork, preferably of all six books, but at a minimum of one whole book
26+
3. File an issue asking for a branch to be made on our main repo, named for that [language's ISO code](http://www.lingoes.net/en/translator/langcode.htm)
27+
4. Once the branch is created, you can PR to merge your translated work in
28+
5. Once the merge is complete, I will promote you to a repository maintainer so you can manage any further translation maintenance work on your own branch of this repo
629

730
## Reading Experience (Chapter/Section links, etc)
831

@@ -18,18 +41,16 @@ The intended **best reading experience** are the published books (either ebook o
1841

1942
## Editions
2043

21-
The current edition of the books is the 2nd edition.
22-
23-
Books 1 ("Get Started") and 2 ("Scope & Closures") were finished and published (ebook and print) back in early 2020, and **are therefore NOT open to further contribution**. Books 3 ("Objects & Classes") and 4 ("Types & Grammar") are in stable-draft status (maybe ~90-95% done), and *are* open to contributions. Books 5 ("Sync & Async") and 6 ("ES.Next & Beyond") are not currently planned to be worked on.
44+
The current (and final) edition of the books is the 2nd edition.
2445

2546
I **am not accepting any contributions** for 1st edition books, no exceptions.
2647

2748
## Typos?
2849

29-
Please don't worry about minor text typos. These will almost certainly be caught during the editing process.
30-
31-
If you're going to submit a PR for typo fixes, please be measured in doing so by collecting several small changes into a single PR (in separate commits). Or, **just don't even worry about them for now,** because we'll get to them later. I promise.
50+
We're not worried about typo fixes anymore. The books are done and published.
3251

3352
## Search First!
3453

35-
Also, if you have any questions or concerns, please make sure to search the issues (both open and closed!) first, to keep the churn of issues to a minimum. I want to keep my focus on writing these books as much as possible.
54+
Seriously, no more need for contributions.
55+
56+
But, if you're going to attempt a contribution, please make sure to search the issues (both open and closed!) first.

README.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@
33
This is a series of books diving deep into the core mechanisms of the JavaScript language. This is the **second edition** of the book series:
44

55
<a href="https://leanpub.com/ydkjsy-get-started"><img src="get-started/images/cover.png" width="75"></a>&nbsp;&nbsp;
6-
<a href="https://leanpub.com/ydkjsy-scope-closures"><img src="scope-closures/images/cover.png" width="75"></a>&nbsp;&nbsp;...
6+
<a href="https://leanpub.com/ydkjsy-scope-closures"><img src="scope-closures/images/cover.png" width="75"></a>&nbsp;&nbsp;
7+
<a href="https://leanpub.com/ydkjsy-unbooks"><img src="unbooks-cover.png" width="75"></a>
78

89
**To read more about the motivations and perspective behind this book series, check out the [Preface](preface.md).**
910

@@ -15,10 +16,11 @@ I recommend reading the **second edition** books in this order:
1516

1617
* [Get Started](get-started/README.md) | [Buy on Leanpub](https://leanpub.com/ydkjsy-get-started) | [Buy on Amazon](https://www.amazon.com/dp/B084BNMN7T)
1718
* [Scope & Closures](scope-closures/README.md) | [Buy on Leanpub](https://leanpub.com/ydkjsy-scope-closures) | [Buy on Amazon](https://www.amazon.com/dp/B08634PZ3N)
19+
* "The Unbooks" (ebook) | [Buy on Leanpub](https://leanpub.com/ydkjsy-unbooks)
1820
* [Objects & Classes](objects-classes/README.md) (draft stable)
19-
* [Types & Grammar](types-grammar/README.md) (draft in progress)
20-
* Sync & Async (not yet started)
21-
* ES.Next & Beyond (not yet started)
21+
* [Types & Grammar](types-grammar/README.md) (rough draft)
22+
* ~~Sync & Async (canceled)~~
23+
* ~~ES.Next & Beyond (canceled)~~
2224

2325
If you're looking for the previous **first edition** books, [they can be found here](https://github.com/getify/You-Dont-Know-JS/blob/1st-ed/README.md).
2426

@@ -36,11 +38,9 @@ If you'd like to contribute financially towards the effort (or any of my other O
3638

3739
## Contributions
3840

39-
Please feel free to contribute to the quality of this content by submitting PRs for improvements to code snippets, explanations, etc. While typo fixes are welcomed, they will likely be caught through normal editing/publishing processes, **so please don't worry about them right now.**
41+
This book series is now complete, and is **not open to further contributions**.
4042

41-
Any contributions you make to this effort **are of course greatly appreciated**.
42-
43-
But **PLEASE** read the [Contributions Guidelines](CONTRIBUTING.md) carefully before submitting a PR.
43+
Thank you to those who've been part of the 11 years journey of this book series.
4444

4545
## Thank You To These Wonderful Sponsors
4646

@@ -60,6 +60,6 @@ I want to extend a warm and deep thanks to Marc Grabanski and the entire Fronten
6060

6161
## License & Copyright
6262

63-
The materials herein are all &copy; 2019-2022 Kyle Simpson.
63+
The materials herein are all &copy; 2019-2025 Kyle Simpson.
6464

65-
<a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-nd/4.0/88x31.png" /></a><br />This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/4.0/">Creative Commons Attribution-NonCommercial-NoDerivs 4.0 Unported License</a>.
65+
<a rel="license" href="https://creativecommons.org/licenses/by-nc-nd/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-nd/4.0/88x31.png" /></a><br />This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-nd/4.0/">Creative Commons Attribution-NonCommercial-NoDerivs 4.0 Unported License</a>.

unbooks-cover.png

2.04 MB
Loading

0 commit comments

Comments
 (0)