Merge branch 'master' into zzowenzz-patch-1

.github/workflows/ci.yml

@@ -1,13 +1,19 @@
 name: Continuous Integration
 
 on:
-  # Triggers the workflow on push or pull request events but only for the "master" branch
+  # Triggers the workflow on push or pull request events only for the specified branches
   push:
     branches:
       - master
+      - r0.17
+      - release
+      - classic
   pull_request_target:
     branches:
       - master
+      - r0.17
+      - release
+      - classic
 
 permissions:
   id-token: write

.github/workflows/clear-cache.yml

@@ -28,7 +28,6 @@ jobs:
     name: Clear CI Cache
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
     - name: Configure AWS Credentials
       uses: aws-actions/configure-aws-credentials@v2
       with:

.gitignore

@@ -31,3 +31,5 @@ build/
 .pytest_cache
 static/latex_style/PT1*
 /chapter_hyperparameter_optimization/std.out
+latex_style/*
+static/latex_style/*

CONTRIBUTING.md

@@ -71,7 +71,7 @@ git clone https://github.com/<UserName>/d2l-en.git
 ```
 
 * Setup your local environment: Create an empty conda environment
-(you may refer to our [Miniconda Installaton](https://d2l.ai/chapter_installation/index.html#installing-miniconda) section in the book).
+(you may refer to our [Miniconda Installation](https://d2l.ai/chapter_installation/index.html#installing-miniconda) section in the book).
 
 * Install the required packages after activating the environment.
 What are the required packages? This depends on the framework you wish to edit. Note that master and release branches may have different

INFO.md

@@ -88,3 +88,78 @@ sudo mv Inconsolata /usr/share/fonts/opentype/
 sudo fc-cache -f -v
 
 ```
+
+## Release checklist
+
+### d2l-en
+
+- release d2lbook
+- [optional, only for hardcopy books or partner products]
+    - fix versions of libs in [setup.py](http://setup.py) → requirements and static/build.yml (including d2lbook)
+    - re-evaluate
+    - fix d2l version (to appear on pypi below) in installation
+- add docstring for d2l.xxx
+- update frontpage announcement
+- (only major) wa 0.8.0 to see if anything needs to be fixed in the main text
+- d2lbook build lib
+- test a random colab
+- http://ci.d2l.ai/computer/d2l-worker/script
+
+```python
+"rm -rf /home/d2l-worker/workspace/d2l-en-release".execute().text
+"rm -rf /home/d2l-worker/workspace/d2l-en-release@2".execute().text
+"rm -rf /home/d2l-worker/workspace/d2l-en-release@tmp".execute().text
+"rm -rf /home/d2l-worker/workspace/d2l-en-release@2@tmp".execute().text
+"ls /home/d2l-worker/workspace/".execute().text
+```
+
+- Evaluate release PR
+- ensure fixed attention randomness in badahnau and transformer
+- ensure libs (e.g., under sagemaker) version consistent between config.ini and build.yml
+- modify version number in config.ini & d2l/__init__.py, and d2l version in installation.md
+- merge master to release by keeping individual commits (create a merge commit)
+- git checkout master
+- rr -rf d2l.egg-info dist
+- upload d2l to pypi (team account)
+- re-test colab and d2l
+- git tag on the release branch
+- git checkout master
+- update README latest version in a branch, then squash and merge to restore
+- [optional] Invalidate CloudFront cache
+- [optional, only for hardcopy books]
+    - config.ini: other_file_s3urls
+- [optional, only for hardcopy books or partner products]
+    - restore versions of libs in [setup.py](http://setup.py) → requirements
+
+### d2l-zh
+
+- update frontpage announcement
+- (need or not?) d2lbook build lib
+- test a random colab
+- upgrade static/build.yml to that in d2l-en
+- [http://ci.d2l.ai/computer/(master)/script](http://ci.d2l.ai/computer/(master)/script)
+- http://ci.d2l.ai/computer/d2l-worker/script
+
+```python
+"rm -rf /home/d2l-worker/workspace/d2l-zh-release".execute().text
+"rm -rf /home/d2l-worker/workspace/d2l-zh-release@2".execute().text
+"rm -rf /home/d2l-worker/workspace/d2l-zh-release@tmp".execute().text
+"rm -rf /home/d2l-worker/workspace/d2l-zh-release@2@tmp".execute().text
+"ls /home/d2l-worker/workspace/".execute().text
+```
+
+- Evaluate release PR (fix attention randomness in badahnau and transformer)
+- ensure libs (e.g., under sagemaker)version consistent between config.ini and build.yml
+- modify version number in config.ini & d2l/__init__.py
+- merge master to release by keeping individual commits (create a merge commit)
+- re-test colab
+- git tag on the release branch
+- git checkout master
+- update README latest version in a branch, then squash and merge to restore
+- 2.0.0 release additional
+    - on s3 console
+        - copy [zh-v2.d2l.ai](http://zh-v2.d2l.ai) bucket/d2l-zh.zip to d2l-webdata bucket/d2l-zh.zip
+        - rename d2l-webdata bucket/d2l-zh.zip to d2l-webdata bucket/d2l-zh-2.0.0.zip
+        - run CI for d2l-zh/release to trigger other_file_s3urls in config
+        - Invalidate cloudfront cache to test installation
+    - test install

README.md

@@ -5,7 +5,6 @@
 # D2L.ai: Interactive Deep Learning Book with Multi-Framework Code, Math, and Discussions
 
 [![Continuous Integration](https://github.com/d2l-ai/d2l-en/actions/workflows/ci.yml/badge.svg)](https://github.com/d2l-ai/d2l-en/actions/workflows/ci.yml)
-[![Build Docker Image](https://github.com/d2l-ai/d2l-en/actions/workflows/build-docker.yml/badge.svg)](https://github.com/d2l-ai/d2l-en/actions/workflows/build-docker.yml)
 
 [Book website](https://d2l.ai/) | [STAT 157 Course at UC Berkeley](http://courses.d2l.ai/berkeley-stat-157/index.html)
 
@@ -33,41 +32,16 @@ Our goal is to offer a resource that could
 </p>
 
 
-## Cool Papers Using D2L
-
-1. [**Descending through a Crowded Valley--Benchmarking Deep Learning Optimizers**](https://arxiv.org/pdf/2007.01547.pdf). R. Schmidt, F. Schneider, P. Hennig. *International Conference on Machine Learning, 2021*
-
-1. [**Universal Average-Case Optimality of Polyak Momentum**](https://arxiv.org/pdf/2002.04664.pdf). D. Scieur, F. Pedregosan. *International Conference on Machine Learning, 2020*
-
-1. [**2D Digital Image Correlation and Region-Based Convolutional Neural Network in Monitoring and Evaluation of Surface Cracks in Concrete Structural Elements**](https://www.mdpi.com/1996-1944/13/16/3527/pdf). M. Słoński, M. Tekieli. *Materials, 2020*
-
-1. [**GluonCV and GluonNLP: Deep Learning in Computer Vision and Natural Language Processing**](https://www.jmlr.org/papers/volume21/19-429/19-429.pdf). J. Guo, H. He, T. He, L. Lausen, M. Li, H. Lin, X. Shi, C. Wang, J. Xie, S. Zha, A. Zhang, H. Zhang, Z. Zhang, Z. Zhang, S. Zheng, and Y. Zhu. *Journal of Machine Learning Research, 2020*
-
-1. [**Detecting Human Driver Inattentive and Aggressive Driving Behavior Using Deep Learning: Recent Advances, Requirements and Open Challenges**](https://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=9107077). M. Alkinani, W. Khan, Q. Arshad. *IEEE Access, 2020*
-
-<details><summary>more</summary>
-
-1. [**Diagnosing Parkinson by Using Deep Autoencoder Neural Network**](https://link.springer.com/chapter/10.1007/978-981-15-6325-6_5). U. Kose, O. Deperlioglu, J. Alzubi, B. Patrut. *Deep Learning for Medical Decision Support Systems, 2020*
-
-1. [**Deep Learning Architectures for Medical Diagnosis**](https://link.springer.com/chapter/10.1007/978-981-15-6325-6_2). U. Kose, O. Deperlioglu, J. Alzubi, B. Patrut. *Deep Learning for Medical Decision Support Systems, 2020*
-
-1. [**ControlVAE: Tuning, Analytical Properties, and Performance Analysis**](https://arxiv.org/pdf/2011.01754.pdf). H. Shao, Z. Xiao, S. Yao, D. Sun, A. Zhang, S. Liu, T. Abdelzaher.
-
-1. [**Potential, challenges and future directions for deep learning in prognostics and health management applications**](https://reader.elsevier.com/reader/sd/pii/S0952197620301184?token=7261E56B97513C5D621B9B5F43CAABEC2860AE3036278C3E5264707C32DCB658077B2AFA6ED6D5CD0FB7B16770828080). O. Fink, Q. Wang, M. Svensén, P. Dersin, W-J. Lee, M. Ducoffe. *Engineering Applications of Artificial Intelligence, 2020*
-
-1. [**Learning User Representations with Hypercuboids for Recommender Systems**](https://arxiv.org/pdf/2011.05742.pdf). S. Zhang, H. Liu, A. Zhang, Y. Hu, C. Zhang, Y. Li, T. Zhu, S. He, W. Ou. *ACM International Conference on Web Search and Data Mining, 2021*
-
-</details>
-
 
 If you find this book useful, please star (★) this repository or cite this book using the following bibtex entry:
 
 ```
-@article{zhang2021dive,
+@book{zhang2023dive,
     title={Dive into Deep Learning},
     author={Zhang, Aston and Lipton, Zachary C. and Li, Mu and Smola, Alexander J.},
-    journal={arXiv preprint arXiv:2106.11342},
-    year={2021}
+    publisher={Cambridge University Press},
+    note={\url{https://D2L.ai}},
+    year={2023}
 }
 ```
 
@@ -83,6 +57,8 @@ If you find this book useful, please star (★) this repository or cite this boo
 > <p>"This is a highly welcome addition to the machine learning literature, with a focus on hands-on experience implemented via the integration of Jupyter notebooks. Students of deep learning should find this invaluable to become proficient in this field."</p>
 > <b>&mdash; Bernhard Schölkopf, Director, Max Planck Institute for Intelligent Systems</b>
 
+> <p>"Dive into Deep Learning strikes an excellent balance between hands-on learning and in-depth explanation. I've used it in my deep learning course and recommend it to anyone who wants to develop a thorough and practical understanding of deep learning."</p>
+> <b>&mdash; Colin Raffel, Assistant Professor, University of North Carolina, Chapel Hill</b>
 
 ## Contributing ([Learn How](https://d2l.ai/chapter_appendix-tools-for-deep-learning/contributing.html))
 
@@ -97,4 +73,4 @@ This open source book is made available under the Creative Commons Attribution-S
 
 The sample and reference code within this open source book is made available under a modified MIT license. See the [LICENSE-SAMPLECODE](LICENSE-SAMPLECODE) file.
 
-[Chinese version](https://github.com/d2l-ai/d2l-zh) | [Discuss and report issues](https://discuss.d2l.ai/) | [Code of conduct](CODE_OF_CONDUCT.md) | [Other Information](INFO.md)
+[Chinese version](https://github.com/d2l-ai/d2l-zh) | [Discuss and report issues](https://discuss.d2l.ai/) | [Code of conduct](CODE_OF_CONDUCT.md)