Merge branch 'main' into adding-project-management-methodologies

.all-contributorsrc

@@ -816,7 +816,10 @@
       "contributions": [
         "content",
         "doc",
-        "review"
+        "review",
+        "code",
+        "infra",
+        "bug"
       ]
     },
     {
@@ -2383,7 +2386,8 @@
       "contributions": [
         "ideas",
         "review",
-        "content"
+        "content",
+        "bug"
       ]
     },
     {
@@ -2551,7 +2555,9 @@
       "profile": "https://github.com/mcnanton",
       "contributions": [
         "bug",
-        "content"
+        "content",
+        "ideas",
+        "translation"
       ]
     },
     {
@@ -2692,7 +2698,9 @@
       "avatar_url": "https://avatars.githubusercontent.com/u/25081046?v=4",
       "profile": "https://github.com/Iain-S",
       "contributions": [
-        "review"
+        "review",
+        "code",
+        "infra"
       ]
     },
     {
@@ -4197,7 +4205,8 @@
       "profile": "https://realrichi3.github.io",
       "contributions": [
         "ideas",
-        "content"
+        "content",
+        "infra"
       ]
     },
     {
@@ -4465,6 +4474,98 @@
       "contributions": [
         "review"
       ]
+    },
+    {
+      "login": "MayaAndersonGonzalez",
+      "name": "Maya Anderson-González",
+      "avatar_url": "https://avatars.githubusercontent.com/u/56874297?v=4",
+      "profile": "https://mayaandersongonzalez.hcommons.org",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "gigikenneth",
+      "name": "Gigi Kenneth",
+      "avatar_url": "https://avatars.githubusercontent.com/u/52600214?v=4",
+      "profile": "https://bit.ly/gigi-kenneth",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "myyong",
+      "name": "myyong",
+      "avatar_url": "https://avatars.githubusercontent.com/u/5417696?v=4",
+      "profile": "https://github.com/myyong",
+      "contributions": [
+        "code",
+        "infra"
+      ]
+    },
+    {
+      "login": "LydiaFrance",
+      "name": "Lydia France",
+      "avatar_url": "https://avatars.githubusercontent.com/u/85945427?v=4",
+      "profile": "https://github.com/LydiaFrance",
+      "contributions": [
+        "code",
+        "infra"
+      ]
+    },
+    {
+      "login": "thessaly",
+      "name": "juli arancio",
+      "avatar_url": "https://avatars.githubusercontent.com/u/33497609?v=4",
+      "profile": "http://julieta.aranc.io",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "mhauru",
+      "name": "Markus Hauru",
+      "avatar_url": "https://avatars.githubusercontent.com/u/5229876?v=4",
+      "profile": "http://mhauru.org",
+      "contributions": [
+        "review"
+      ]
+    },
+    {
+      "login": "Jerzeek",
+      "name": "Jerry de Vos",
+      "avatar_url": "https://avatars.githubusercontent.com/u/22919620?v=4",
+      "profile": "http://jerrydevos.com",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "SachaHq",
+      "name": "Sacha Hodencq",
+      "avatar_url": "https://avatars.githubusercontent.com/u/58265506?v=4",
+      "profile": "https://github.com/SachaHq",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "zimolzak",
+      "name": "Andy Zimolzak",
+      "avatar_url": "https://avatars.githubusercontent.com/u/2705315?v=4",
+      "profile": "https://github.com/zimolzak",
+      "contributions": [
+        "bug"
+      ]
+    },
+    {
+      "login": "Cghlewis",
+      "name": "Cghlewis",
+      "avatar_url": "https://avatars.githubusercontent.com/u/33465957?v=4",
+      "profile": "http://cghlewis.com",
+      "contributions": [
+        "bug"
+      ]
     }
   ],
   "projectName": "the-turing-way",

.github/ISSUE_TEMPLATE/give_a_talk.yml

@@ -38,7 +38,7 @@ body:
     attributes:
       value: |
         ---
-        :warning: _Warning_ :warning:
+        ⚠️  _Warning_ ⚠️
 
         _This issue will be automatically closed by a [GitHub Actions](https://docs.github.com/en/actions) workflow when more_
         _than 7 days have passed since the date of the talk. If you are still working_

.github/config.yml

@@ -6,8 +6,8 @@
 newIssueWelcomeComment: >
   [![Welcome Banner](https://zenodo.org/api/iiif/record:3695300:BannerWelcome.jpg/full/!750,750/0/default.jpg)](https://zenodo.org/record/3695300)
 
-  :tada: Welcome to _The Turing Way_! :tada:
-  We're really excited to have your input into the project! :sparkling_heart:
+  🎉 Welcome to _The Turing Way_! 🎉
+  We're really excited to have your input into the project! 💖
 
   <br>If you haven't done so already, please make sure you check out our [Contributing Guidelines](https://github.com/the-turing-way/the-turing-way/blob/main/CONTRIBUTING.md) and [Code of Conduct](https://github.com/the-turing-way/the-turing-way/blob/main/CODE_OF_CONDUCT.md).
   If you need to connect more synchronously with members of _The Turing Way_ community, please feel free to chat with us in our [Slack workspace](https://join.slack.com/t/theturingway/shared_invite/zt-fn608gvb-h_ZSpoA29cCdUwR~TIqpBw), or you can join our [Collaboration Cafe](https://the-turing-way.netlify.app/community-handbook/coworking/coworking-collabcafe.html) for mentored contribution or co-working.
@@ -18,20 +18,20 @@ newIssueWelcomeComment: >
 newPRWelcomeComment: >
   [![Thank You Banner](https://zenodo.org/api/iiif/record:3695300:BannerThanks.jpg/full/!750,750/0/default.jpg)](https://zenodo.org/record/3695300)
 
-  :sparkling_heart: Thanks for opening this pull request! :sparkling_heart:
+  💖 Thanks for opening this pull request! 💖
   _The Turing Way_ community really appreciates your time and effort to contribute to the project.
   Please make sure you have read our [Contributing Guidelines](https://github.com/the-turing-way/the-turing-way/blob/main/CONTRIBUTING.md) and filled in our pull request template to the best of your ability.
 
-  If you are submitting a new chapter, here are some things that will help get your pull request across the finish line! :checkered_flag:
+  If you are submitting a new chapter, here are some things that will help get your pull request across the finish line! 🏁
 
   - Check you have removed all _lorem ipsums_ from the chapter template (if you used it)
 
   - Check for any abbreviations or latin phrases (such as "e.g." or "i.e.") in your writing. See our [style guide](https://github.com/the-turing-way/the-turing-way/blob/main/CONTRIBUTING.md#writing-style) for more information on this topic.
 
   - Make sure you have added your new chapter to the [Table of Contents](https://github.com/the-turing-way/the-turing-way/blob/main/book/website/_toc.yml)
 
-  <br>We have Continuous Integration tests that check the writing style and will help you track down any slip-ups :recycle:
-  The Netlify bot will also comment with a preview of the book with your additions so you can see how it will look once it's merged! :tada:
+  <br>We have Continuous Integration tests that check the writing style and will help you track down any slip-ups ♻
+  The Netlify bot will also comment with a preview of the book with your additions so you can see how it will look once it's merged! 🎉
 
   <br>We get a lot of pull requests on this repo, so please be patient and we will get back to you as soon as we can.
   If we don't acknowledge this pull request after 7 days, feel free to chat to us about it in our [Slack workspace](https://join.slack.com/t/theturingway/shared_invite/zt-fn608gvb-h_ZSpoA29cCdUwR~TIqpBw).
@@ -42,6 +42,6 @@ newPRWelcomeComment: >
 firstPRMergeComment: >
   [![Congratulations Banner](https://zenodo.org/api/iiif/record:3695300:BannerCongratulations.jpg/full/!750,750/0/default.jpg)](https://zenodo.org/record/3695300)
 
-  Congrats on merging your first pull request! :tada:
-  We here at _The Turing Way_ are proud of you! :sparkling_heart:
-  Thank you so much for your contribution :gift:
+  Congrats on merging your first pull request! 🎉
+  We here at _The Turing Way_ are proud of you! 💖
+  Thank you so much for your contribution 🎁

.github/workflows/ci.yml

@@ -28,7 +28,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python_version: ["3.10"]
+        python_version: ["3.8"]
       fail-fast: false # Don't cancel all jobs if one fails
 
     runs-on: ${{ matrix.os }}
@@ -43,14 +43,33 @@ jobs:
           python-version: ${{ matrix.python_version }}
 
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip setuptools wheel
-          pip install -r ./book/website/requirements.txt
+        run: make deps
+        working-directory: ./book
 
-      - name: Build Jupyter-Book
-        run: |
-          cd ./book/website
-          jupyter-book build . -W --keep-going
+      - name: Build Jupyter-Book with warnings raised to errors
+        run: make strict
+        working-directory: ./book
+
+  build-pathways:
+    name: Build Pathways
+    needs: build-jb
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout-repository
+        uses: actions/checkout@v3
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.8"
+
+      - name: Install dependencies
+        run: make deps
+        working-directory: ./book
+
+      - name: Run pathways script
+        run: make pathways
+        working-directory: ./book
 
   offline-link-check:
     name: Link Check
@@ -63,17 +82,15 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
-          python-version: "3.10"
+          python-version: "3.8"
 
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip setuptools wheel
-          pip install -r ./book/website/requirements.txt
+        run: make deps
+        working-directory: ./book
 
       - name: Build Jupyter-Book
-        run: |
-          cd ./book/website
-          jupyter-book build .
+        run: make book
+        working-directory: ./book
 
       - name: Check offline links
         uses: lycheeverse/lychee-action@v1.8.0

.github/workflows/close-talk-issues.yml

@@ -28,7 +28,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
-          python-version: "3.10"
+          python-version: "3.8"
 
       - name: Install ghapi to interact with the GitHub REST API
         run: |
@@ -146,7 +146,7 @@ jobs:
               api.issues.create(
                   owner=owner,
                   repo=repo,
-                  title=":robot: Recent talks to promote in the newsletter",
+                  title="🤖 Recent talks to promote in the newsletter",
                   body=body,
                   labels=[newsletter_label],
                   assignees=[community_manager],

.github/workflows/crowdin-contributors.yml

@@ -0,0 +1,48 @@
+name: Crowdin Contributors Action
+
+on:
+  schedule:
+    - cron: '0 0 * * 1' # 'https://crontab.guru/#0_0_*_*_1'
+  # To manually run this workflow
+  workflow_dispatch:
+
+jobs:
+  crowdin-contributors:
+
+    runs-on: ubuntu-latest
+
+    permissions:
+      pull-requests: write
+      contents: write
+
+    # This environment contains secrets specific to crowdin and only workflows
+    # listing this environment can use them
+    environment: crowdin
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Generate Crowdin Contributors table
+        uses: andrii-bodnar/action-crowdin-contributors@v1.0.1
+        with:
+          contributors_per_line: 5
+          max_contributors: 10000
+          image_size: 100
+          min_words_contributed: 1
+          include_languages: true
+          placeholder_start: <!-- CROWDIN-CONTRIBUTORS-LIST:START -->
+          placeholder_end: <!-- CROWDIN-CONTRIBUTORS-LIST:END -->
+          crowdin_project_link: https://turingway.crowdin.com/turing-way
+        env:
+          CROWDIN_PROJECT_ID: 1
+          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
+          CROWDIN_ORGANIZATION: turingway
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v4
+        with:
+          title: Update Crowdin Contributors table
+          body: By [action-crowdin-contributors](https://github.com/andrii-bodnar/action-crowdin-contributors) GitHub action
+          commit-message: Update Crowdin Contributors table
+          committer: Crowdin Bot <support+bot@crowdin.com>
+          branch: crowdin-contributors/patch

.github/workflows/external_link_check.yml

@@ -16,17 +16,15 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
-          python-version: "3.10"
+          python-version: "3.8"
 
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip setuptools wheel
-          pip install -r ./book/website/requirements.txt
+        run: make deps
+        working-directory: ./book/website
 
       - name: Build Jupyter-Book
-        run: |
-          cd ./book/website
-          jupyter-book build .
+        run: make book
+        working-directory: ./book/website
 
       - name: Restore lychee cache
         uses: actions/cache@v3
@@ -43,8 +41,7 @@ jobs:
           GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}} # Use runner's GitHub token to avoid rate limiting
 
       - name: Concatenate Lychee output with issue header
-        run: |
-          cat .github/workflows/resources/external_link_check_header.md lychee/out.md > issue_text.md
+        run: cat .github/workflows/resources/external_link_check_header.md lychee/out.md > issue_text.md
 
       - name: Update Issue
         uses: peter-evans/create-issue-from-file@v4

.github/workflows/lorem-ipsums.yml

@@ -28,10 +28,10 @@ jobs:
       # Checkout the repository. Relies on another GH-Action.
       - uses: actions/checkout@v3
       # Set up the Python version. Relies on another GH-Action.
-      - name: Setup Python 3.10
+      - name: Setup Python 3.8
         uses: actions/setup-python@v4
         with:
-          python-version: "3.10"
+          python-version: "3.8"
       # Install Python dependencies
       - name: Install dependencies
         working-directory: ./tests