Merge branch 'main' into main

tomthorogood · web-flow · commit be24e586cabf · 2026-01-21T10:08:59.000-08:00
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -13,11 +13,11 @@ jobs:
       - name: Set up Git repository
         uses: actions/checkout@v6.0.1
       - name: Set up Ruby
-        uses: ruby/setup-ruby@4c24fa5ec04b2e79eb40571b1cee2a0d2b705771 # v1
+        uses: ruby/setup-ruby@708024e6c902387ab41de36e1669e43b5ee7085e # v1
         with:
           bundler-cache: true
       - name: Set up Node
-        uses: actions/setup-node@v6.1.0
+        uses: actions/setup-node@v6.2.0
       - name: Bootstrap
         run: script/bootstrap
         env:
diff --git a/Gemfile.lock b/Gemfile.lock
@@ -13,10 +13,10 @@ GEM
       minitest (>= 5.1)
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
     afm (1.0.0)
-    async (2.34.0)
+    async (2.35.1)
       console (~> 1.29)
       fiber-annotation
       io-event (~> 1.11)
@@ -55,17 +55,17 @@ GEM
       logger
     faraday-net_http (3.3.0)
       net-http
-    ffi (1.17.2-aarch64-linux-gnu)
-    ffi (1.17.2-aarch64-linux-musl)
-    ffi (1.17.2-arm-linux-gnu)
-    ffi (1.17.2-arm-linux-musl)
-    ffi (1.17.2-arm64-darwin)
-    ffi (1.17.2-x64-mingw-ucrt)
-    ffi (1.17.2-x86-linux-gnu)
-    ffi (1.17.2-x86-linux-musl)
-    ffi (1.17.2-x86_64-darwin)
-    ffi (1.17.2-x86_64-linux-gnu)
-    ffi (1.17.2-x86_64-linux-musl)
+    ffi (1.17.3-aarch64-linux-gnu)
+    ffi (1.17.3-aarch64-linux-musl)
+    ffi (1.17.3-arm-linux-gnu)
+    ffi (1.17.3-arm-linux-musl)
+    ffi (1.17.3-arm64-darwin)
+    ffi (1.17.3-x64-mingw-ucrt)
+    ffi (1.17.3-x86-linux-gnu)
+    ffi (1.17.3-x86-linux-musl)
+    ffi (1.17.3-x86_64-darwin)
+    ffi (1.17.3-x86_64-linux-gnu)
+    ffi (1.17.3-x86_64-linux-musl)
     fiber-annotation (0.2.0)
     fiber-local (1.1.0)
       fiber-storage
@@ -128,7 +128,7 @@ GEM
     html-pipeline (2.14.3)
       activesupport (>= 2)
       nokogiri (>= 1.4)
-    html-proofer (5.1.1)
+    html-proofer (5.2.0)
       addressable (~> 2.3)
       async (~> 2.1)
       benchmark (~> 0.5)
@@ -252,7 +252,7 @@ GEM
       gemoji (>= 3, < 5)
       html-pipeline (~> 2.2)
       jekyll (>= 3.0, < 5.0)
-    json (2.16.0)
+    json (2.18.0)
     kramdown (2.4.0)
       rexml
     kramdown-parser-gfm (1.1.0)
@@ -298,7 +298,7 @@ GEM
       sawyer (~> 0.9)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
-    pdf-reader (2.15.0)
+    pdf-reader (2.15.1)
       Ascii85 (>= 1.0, < 3.0, != 2.0.0)
       afm (>= 0.2.1, < 2)
       hashery (~> 2.0)
@@ -339,7 +339,7 @@ GEM
     uri (0.13.3)
     webrick (1.8.2)
     yell (2.2.2)
-    zeitwerk (2.7.3)
+    zeitwerk (2.7.4)
 
 PLATFORMS
   aarch64-linux-gnu
diff --git a/_articles/ar/maintaining-balance-for-open-source-maintainers.md b/_articles/ar/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: ar
-untranslated: true
 title: الحفاظ على التوازن لمشرفي المشاريع مفتوحة المصدر
 description: نصائح للعناية الذاتية وتجنب الإرهاق كمشرف
 class: balance
diff --git a/_articles/ar/security-best-practices-for-your-project.md b/_articles/ar/security-best-practices-for-your-project.md
@@ -1,6 +1,5 @@
 ---
 lang: ar
-untranslated: true
 title: أفضل ممارسات الأمان لمشروعك
 description: عزز مستقبل مشروعك من خلال بناء الثقة من خلال الممارسات الأمان الأساسية — من MFA و مسح الكود الى الادارة الأمنة للتبعيات  وإعداد تقارير الثغرات الأمنية الخاصة
 class: security-best-practices
diff --git a/_articles/bg/maintaining-balance-for-open-source-maintainers.md b/_articles/bg/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: bg
-untranslated: true
 title: Поддържане на баланс за поддържащите отворен код
 description: Съвети за самообслужване и избягване на прегаряне като поддържащ.
 class: balance
diff --git a/_articles/bg/security-best-practices-for-your-project.md b/_articles/bg/security-best-practices-for-your-project.md
@@ -1,6 +1,5 @@
 ---
 lang: bg
-untranslated: true
 title: Най-добри практики за сигурност за вашия проект
 description: Укрепете бъдещето на вашия проект, като изградите доверие чрез основни практики за сигурност – от многофакторна автентификация (MFA) и сканиране на код до безопасно управление на зависимостите и отчитане на частни уязвимости.
 class: security-best-practices
diff --git a/_articles/es/maintaining-balance-for-open-source-maintainers.md b/_articles/es/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: es
-untranslated: true
 title: Mantener el equilibrio para los contribuidores de código abierto
 description: Consejos para el autocuidado y evitar el agotamiento como contribuidor.
 class: balance
diff --git a/_articles/es/security-best-practices-for-your-project.md b/_articles/es/security-best-practices-for-your-project.md
@@ -1,6 +1,5 @@
 ---
 lang: es
-untranslated: true
 title: Buenas prácticas de seguridad para tu proyecto
 description: Fortalece el futuro de tu proyecto generando confianza mediante prácticas esenciales de seguridad — desde la autenticación multifactor (MFA) y el análisis de código hasta la gestión segura de dependencias y la notificación privada de vulnerabilidades.
 class: security-best-practices
diff --git a/_articles/fa/maintaining-balance-for-open-source-maintainers.md b/_articles/fa/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: fa
-untranslated: true
 title: حفظ تعادل برای نگهدارندگان پروژه‌های متن‌باز
 description: نکاتی برای مراقبت از خود و جلوگیری از فرسودگی به عنوان یک نگهدارنده
 class: balance
diff --git a/_articles/fa/security-best-practices-for-your-project.md b/_articles/fa/security-best-practices-for-your-project.md
@@ -1,6 +1,5 @@
 ---
 lang: fa
-untranslated: true
 title: بهترین روش‌های امنیتی برای پروژه شما
 description: آینده پروژه خود را با ایجاد اعتماد از طریق روش‌های امنیتی ضروری تقویت کنید - از MFA و اسکن کد گرفته تا مدیریت ایمن وابستگی‌ها و گزارش‌دهی آسیب‌پذیری خصوصی.
 class: security-best-practices
diff --git a/_articles/fr/maintaining-balance-for-open-source-maintainers.md b/_articles/fr/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: fr
-untranslated: true
 title: Maintenir l'équilibre chez les Mainteneurs de code Open Source
 description: Conseils d'écologie personnelle et commen éviter le burnout en tant que mainteneur.
 class: balance
diff --git a/_articles/hi/maintaining-balance-for-open-source-maintainers.md b/_articles/hi/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: hi
-untranslated: true
 title: ओपन सोर्स अनुरक्षकों के लिए संतुलन बनाए रखना
 description: एक अनुचर के रूप में स्वयं की देखभाल और बर्नआउट से बचने के लिए युक्तियाँ।
 class: balance
diff --git a/_articles/it/maintaining-balance-for-open-source-maintainers.md b/_articles/it/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: it
-untranslated: true
 title: Mantenere l'equilibrio per i sostenitori dell'open source
 description: Suggerimenti per la cura di sé ed evitare il burnout come caregiver.
 class: balance
diff --git a/_articles/it/security-best-practices-for-your-project.md b/_articles/it/security-best-practices-for-your-project.md
@@ -1,6 +1,5 @@
 ---
 lang: it
-untranslated: true
 title: Le migliori pratiche di sicurezza per il tuo progetto
 description: Rafforza il futuro del tuo progetto creando fiducia attraverso pratiche di sicurezza essenziali, dall'MFA e dalla scansione del codice alla gestione sicura delle dipendenze e alla segnalazione di vulnerabilità private.
 class: security-best-practices
diff --git a/_articles/ko/maintaining-balance-for-open-source-maintainers.md b/_articles/ko/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: ko
-untranslated: true
 title: 오픈 소스 메인테이너를 위한 균형 유지
 description: 메인테이너를 위한 자기 관리 및 번아웃 방지 팁
 class: balance
diff --git a/_articles/maintaining-balance-for-open-source-maintainers.md b/_articles/maintaining-balance-for-open-source-maintainers.md
@@ -8,7 +8,7 @@ order: 0
 image: /assets/images/cards/maintaining-balance-for-open-source-maintainers.png
 ---
 
-As an open source project grows in popularity, it becomes important to set clear boundaries to help you maintain balance to stay refreshed and productive for the long run. 
+As an open source project grows in popularity, it becomes important to set clear boundaries to help you maintain balance to stay refreshed and productive for the long run.
 
 To gain insights into the experiences of maintainers and their strategies for finding balance, we ran a workshop with 40 members of the <a href="http://maintainers.github.com/">Maintainer Community</a>, allowing us to learn from their firsthand experiences with burnout in open source and the practices that have helped them maintain balance in their work. This is where the concept of personal ecology comes into play.
 
@@ -73,7 +73,7 @@ It's important to understand what causes us to get burned out. Here are a few co
   </p>
 </aside>
 
-* **Conflicting demands:**  Open source is full of groups with different motivations, which can be difficult to navigate. If you're paid to do open source, your employer's interests can sometimes be at odds with the community.
+* **Conflicting demands:** Open source is full of groups with different motivations, which can be difficult to navigate. If you're paid to do open source, your employer's interests can sometimes be at odds with the community.
 
 <aside markdown="1" class="pquote">
   With paid open source, conflict between employer's focus and what's best for the community
@@ -99,7 +99,7 @@ There are tools like the [Burnout Checklist](https://governingopen.com/resources
 
 This will look different for each maintainer, and will change depending on your phase of life and other external factors. But here are a few themes we heard:
 
-* **Lean on the community:** Delegation and finding contributors can alleviate the workload. Having multiple points of contact for a project can help you take a break without worrying. Connect with other maintainers and the wider community–in groups like the [Maintainer Community](http://maintainers.github.com/). This can be a great resource for peer support and learning. 
+* **Lean on the community:** Delegation and finding contributors can alleviate the workload. Having multiple points of contact for a project can help you take a break without worrying. Connect with other maintainers and the wider community–in groups like the [Maintainer Community](http://maintainers.github.com/). This can be a great resource for peer support and learning.
 
   You can also look for ways to engage with the user community, so you can regularly hear feedback and understand the impact of your open source work.
 
@@ -144,7 +144,7 @@ To meaningfully trust others on these axes, you cannot be someone who says yes t
   </p>
 </aside>
 
-  Learn to be firm in shutting down toxic behavior and negative interactions. It's okay to not give energy to things you don't care about.
+Learn to be firm in shutting down toxic behavior and negative interactions. It's okay to not give energy to things you don't care about.
 
 <aside markdown="1" class="pquote">
   <img src="https://avatars.githubusercontent.com/IvanSanchez?s=180" class="pquote-avatar" alt="avatar">
@@ -156,7 +156,7 @@ My software is gratis, but my time and attention is not.
 
 <aside markdown="1" class="pquote">
   <img src="https://avatars.githubusercontent.com/foosel?s=180" class="pquote-avatar" alt="avatar">
-It's no secret that open source maintenance has its dark sides, and one of these is having to sometimes interact with quite ungrateful, entitled or outright toxic people. As a project's popularity increases, so does the frequency of this kind of interaction, adding to the burden shouldered by maintainers and possibly becoming a significant risk factor for maintainer burnout.  
+It's no secret that open source maintenance has its dark sides, and one of these is having to sometimes interact with quite ungrateful, entitled or outright toxic people. As a project's popularity increases, so does the frequency of this kind of interaction, adding to the burden shouldered by maintainers and possibly becoming a significant risk factor for maintainer burnout.
   <p markdown="1" class="pquote-credit">
 — <a href="https://github.com/foosel">@foosel</a>, maintainer of Octoprint on [How to deal with toxic people](https://www.youtube.com/watch?v=7lIpP3GEyXs)
   </p>
@@ -168,7 +168,7 @@ Remember, personal ecology is an ongoing practice that will evolve as you progre
 
 * [Maintainer Community](http://maintainers.github.com/)
 * [The social contract of open source](https://snarky.ca/the-social-contract-of-open-source/), Brett Cannon
-* [Uncurled](https://daniel.haxx.se/uncurled/), Daniel Stenberg 
+* [Uncurled](https://daniel.haxx.se/uncurled/), Daniel Stenberg
 * [How to deal with toxic people](https://www.youtube.com/watch?v=7lIpP3GEyXs), Gina Häußge
 * [SustainOSS](https://sustainoss.org/)
 * [Rockwood Art of Leadership](https://rockwoodleadership.org/art-of-leadership/)
@@ -179,7 +179,7 @@ Remember, personal ecology is an ongoing practice that will evolve as you progre
 
 Many thanks to all the maintainers who shared their experiences and tips with us for this guide!
 
-This guide was written by [@abbycabs](https://github.com/abbycabs) with contributions from: 
+This guide was written by [@abbycabs](https://github.com/abbycabs) with contributions from:
 
 [@agnostic-apollo](https://github.com/agnostic-apollo)
 [@AndreaGriffiths11](https://github.com/AndreaGriffiths11)
diff --git a/_articles/pl/maintaining-balance-for-open-source-maintainers.md b/_articles/pl/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: pl
-untranslated: true
 title: Utrzymanie równowagi dla opiekunów Open Source
 description: Wskazówki dotyczące dbania o siebie i unikania wypalenia jako opiekun.
 class: balance
diff --git a/_articles/ru/maintaining-balance-for-open-source-maintainers.md b/_articles/ru/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: ru
-untranslated: true
 title: Поддержание баланса для мейнтейнеров в Open Source
 description: Советы по заботе о себе и предотвращению выгорания в работе мейнтейнера.
 class: balance
diff --git a/_articles/ru/security-best-practices-for-your-project.md b/_articles/ru/security-best-practices-for-your-project.md
@@ -1,6 +1,5 @@
 ---
 lang: ru
-untranslated: true
 title: Лучшие практики безопасности для вашего Проекта
 description: Укрепите будущее своего проекта, укрепляя доверие с помощью основных методов обеспечения безопасности — от многофакторной аутентификации и сканирования кода до безопасного управления зависимостями и конфиденциальных отчетов об уязвимостях.
 class: security-best-practices
diff --git a/_articles/sw/maintaining-balance-for-open-source-maintainers.md b/_articles/sw/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: sw
-untranslated: true
 title: Kudumisha Mizani kwa Watunzaji wa Open Source
 description: Vidokezo vya kujitunza na kuepuka uchovu kama mtunzaji.
 class: balance
diff --git a/_articles/zh-hans/maintaining-balance-for-open-source-maintainers.md b/_articles/zh-hans/maintaining-balance-for-open-source-maintainers.md
@@ -1,6 +1,5 @@
 ---
 lang: zh-hans
-untranslated: true
 title: 保持开源维护者的平衡
 description: 作为维护者的自我护理和避免倦怠的技巧。
 class: balance
diff --git a/_articles/zh-hans/security-best-practices-for-your-project.md b/_articles/zh-hans/security-best-practices-for-your-project.md
@@ -1,6 +1,5 @@
 ---
 lang: zh-hans
-untranslated: true
 title: 项目安全最佳实践
 description: 从多因素认证和代码扫描，到安全的依赖管理和私人漏洞报告，通过这些必要安全实践建立信任，为项目长远发展保驾护航。
 class: security-best-practices
diff --git a/docs/translations.md b/docs/translations.md
@@ -13,6 +13,7 @@ If there's not, then today is your day to lead this effort! Here's how to start:
 1. Create a new branch for your translation work e.g. `es`.
 1. Copy `_data/locales/en.yml` to your target language file e.g. `_data/locales/es.yml` and translate all the strings.
 1. Create a new directory in `_articles/` for your language e.g. `_articles/es/`, copy each guide from `_articles/` into that folder and translate the content in each guide, except for the field names in the front matter between the `---`s at the top of each file, e.g., `title:` should remain unchanged.
+1. Remove the untranslated field.
 1. Copy `index.html` to your target language index file e.g. `[_articles/es/index.html](https://github.com/github/opensource.guide/blob/HEAD/_articles/es/index.html)` and update the `lang:` and add the `permalink:` fields. Example: `lang: es` and `permalink: /es/`. All other fields' values must remain unchanged.
 1. Run `script/test` and make sure there are no failures with your translation files. Note that you may need to fix broken links.
 1. Send a pull request. (You may send a pull request before all steps above are complete: e.g., you may want to ask for help with translations, or getting tests to pass. However, your pull request will not be merged until all steps above are complete.)
