From d03999ee7697611a5d192b9220808863069dcecb Mon Sep 17 00:00:00 2001 From: Shai Demri Date: Mon, 21 Aug 2023 11:15:31 +0300 Subject: [PATCH 1/3] Update README.hebrew.md Fix some typos and improve translation to be closer to the english source --- README.hebrew.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.hebrew.md b/README.hebrew.md index ff79bb703..9ab3bd28d 100644 --- a/README.hebrew.md +++ b/README.hebrew.md @@ -269,7 +269,7 @@ my-system ## ![✔] 1.3 עטפו כלים משותפים בחבילות, שקלו את הפצתם -**אמ;לק:** מקמו את כל הכלים שאפשר לשתף אותם בתיקייה ייעודית, למשל 'libraries' וכל כלי בתיקייה פנימית נפרדת, למשל '/libraries/logger'. הפכו את הכלי לחבילה בלתי תלויה עם קובץ ה package.json שלו וזאת כדי להגדיל את הכימוס (encapsulation), ואפשרו הפצה עתידית למאגר. כאשר הפרוייקט שלכם בנוי בתצורת monorepo, כלים אלו יכולים להיות מוגדרים על ידי שימוש ב 'npm linking' לכתובת הפיזית שלהם על ידי שימוש ב ts-paths או על ידי הפצה והתקנה על ידימנהל חבילות כדוגמת 'npm registry'. +**אמ;לק:** מקמו את כל הכלים שאפשר לשתף אותם בתיקייה ייעודית, למשל 'libraries' וכל כלי בתיקייה פנימית נפרדת, למשל '/libraries/logger'. הפכו את הכלי לחבילה בלתי תלויה עם קובץ ה package.json שלו וזאת כדי להגדיל את הכימוס (encapsulation), ואפשרו הפצה עתידית למאגר. כאשר הפרוייקט שלכם בנוי בתצורת monorepo, כלים אלו יכולים להיות מוגדרים על ידי שימוש ב 'npm linking' לכתובת הפיזית שלהם על ידי שימוש ב ts-paths או על ידי הפצה והתקנה על ידי מנהל חבילות כדוגמת 'npm registry'. ```bash my-system @@ -301,7 +301,7 @@ my-system ## ![✔] 1.5 שקלו את כל ההשלכות בעת בחירת מסגרת -**אמ;לק:** כאשר בונים אפליקציות ו API-ים, שימוש בפריימוורק הוא חובה. קל להתעלם מהאפשרויות השונות שקיימות ומשיקולים חשובים ובסופו של דבר להשתמש באפשרות שפחות תואמת לדרישות של המוצר. נכון ל2023/2024 אנו מאמינים כי ארבעת הפריימוורקים הללו הם הכדאיים ביותר להשוואה: [Nest.js](https://nestjs.com/), [Fastify](https://www.fastify.io/), [express](https://expressjs.com/), ו [Koa](https://koajs.com/). לחצו על לקריאה נוספת בהמשך כדי לקרוא פרטים נוספים בעד ונגד כל אחת מהאפשרויות. באופן פשטני, אנו מאמינים כי Node.js זאת ההתאמה הכי טובה לצוותים שרוצים לעבוד בשיטת OOP או לבנות מוצרים שמיועדים לגדול בצורה ניכרת ואי אפשר לחלק אותם לרכיבים קטנים _ועצמאיים_. ההמלצה שלנו היא Fastify עבור מערכות בגודל סבירents (כמו Microservices) שמושתתים על עקרונות פשוטים של Node.js. +**אמ;לק:** כאשר בונים אפליקציות ו API-ים, שימוש בפריימוורק הוא חובה. קל להתעלם מהאפשרויות השונות שקיימות ומשיקולים חשובים ובסופו של דבר להשתמש באפשרות שפחות תואמת לדרישות של המוצר. נכון ל2023/2024 אנו מאמינים כי ארבעת הפריימוורקים הללו הם הכדאיים ביותר להשוואה: [Nest.js](https://nestjs.com/), [Fastify](https://www.fastify.io/), [express](https://expressjs.com/), ו [Koa](https://koajs.com/). לחצו על לקריאה נוספת בהמשך כדי לקרוא פרטים נוספים בעד ונגד כל אחת מהאפשרויות. באופן פשטני, אנו מאמינים כי Nest.js זאת ההתאמה הכי טובה לצוותים שרוצים לעבוד בשיטת תכנות מונחה עצמים או לבנות מוצרים שמיועדים לגדול בצורה ניכרת ואי אפשר לחלק אותם לרכיבים קטנים _ועצמאיים_. ההמלצה שלנו היא Fastify עבור מערכות בעלות רכיביבם בגודל סביר (כמו Microservices) שמושתתים על עקרונות פשוטים של Node.js. **אחרת:** בשל הכמות העצומה של השיקולים, קל לקבל החלטה על בסיס מידע חלקי ולהשוות תפוחים לתפוזים. למשל, ישנה הנחה רווחת שFastify הוא web-server מינימלי שראוי להשוות לexpress בלבד. בפועל, זהו פריימוורק עשיר עם הרבה הרחבות רשמיות שמכסות הרבה צרכים. From 057fb7ead270571c77f35e98589f0f647af9b808 Mon Sep 17 00:00:00 2001 From: Shai Demri Date: Wed, 23 Aug 2023 15:10:06 +0300 Subject: [PATCH 2/3] Translate section 5.11 README.hebrew.md Translate section 5.11 README.hebrew.md --- README.hebrew.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/README.hebrew.md b/README.hebrew.md index 9ab3bd28d..ec29c7a77 100644 --- a/README.hebrew.md +++ b/README.hebrew.md @@ -922,13 +922,12 @@ API, הודעה חדשה נרשמת לתור, וקריאה לכלי צפיה ב

-## ![✔] 5.11. Get your frontend assets out of Node +## ![✔] 5.11. הוציאו את קבצי צד הלקוח שלכם מחוץ ל-Node -**אמ;לק:** Serve frontend content using a specialized infrastructure (nginx, S3, CDN) because Node performance gets hurt when dealing with many static files due to its single-threaded model. One exception to this guideline is when doing server-side rendering +**אמ;לק:** שרתו את תוכן צד הלקוח באמצעות תשתית ייעודית (nginx, S3, CDN) מאחר שהביצועים של Node נפגעים מהתעסקות עם המון קבצים סטטים עקב מודל החוט היחיד. +**אחרת:** חוט ה-Node היחיד שלכם יהיה עסוק בהזרמת מאות קבצי html/תמונות/אנגולר/ריאקט במקום להקצות את כל המשאבים שלו עבור המשימה לשמה הוא נועד - לשרת תוכן דינמי. -**אחרת:** Your single Node thread will be busy streaming hundreds of html/images/angular/react files instead of allocating all its resources for the task it was born for – serving dynamic content - -🔗 [**Read More: Get your frontend assets out of Node**](./sections/production/frontendout.md) +🔗 [**לקריאה נוספת: הוציאו את קבצי צד הלקוח שלכם מחוץ ל-Node**](./sections/production/frontendout.md)

From 677e2624dbc1bfaecb484dc0bc02924f8565066e Mon Sep 17 00:00:00 2001 From: Shai Demri Date: Wed, 23 Aug 2023 15:34:50 +0300 Subject: [PATCH 3/3] Update README.hebrew.md Co-authored-by: Nick Ribal --- README.hebrew.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.hebrew.md b/README.hebrew.md index ec29c7a77..adcde788c 100644 --- a/README.hebrew.md +++ b/README.hebrew.md @@ -301,7 +301,8 @@ my-system ## ![✔] 1.5 שקלו את כל ההשלכות בעת בחירת מסגרת -**אמ;לק:** כאשר בונים אפליקציות ו API-ים, שימוש בפריימוורק הוא חובה. קל להתעלם מהאפשרויות השונות שקיימות ומשיקולים חשובים ובסופו של דבר להשתמש באפשרות שפחות תואמת לדרישות של המוצר. נכון ל2023/2024 אנו מאמינים כי ארבעת הפריימוורקים הללו הם הכדאיים ביותר להשוואה: [Nest.js](https://nestjs.com/), [Fastify](https://www.fastify.io/), [express](https://expressjs.com/), ו [Koa](https://koajs.com/). לחצו על לקריאה נוספת בהמשך כדי לקרוא פרטים נוספים בעד ונגד כל אחת מהאפשרויות. באופן פשטני, אנו מאמינים כי Nest.js זאת ההתאמה הכי טובה לצוותים שרוצים לעבוד בשיטת תכנות מונחה עצמים או לבנות מוצרים שמיועדים לגדול בצורה ניכרת ואי אפשר לחלק אותם לרכיבים קטנים _ועצמאיים_. ההמלצה שלנו היא Fastify עבור מערכות בעלות רכיביבם בגודל סביר (כמו Microservices) שמושתתים על עקרונות פשוטים של Node.js. +**אמ;לק:** כאשר בונים אפליקציות ו API-ים, שימוש בפריימוורק הוא חובה. קל להתעלם מהאפשרויות השונות שקיימות ומשיקולים חשובים ובסופו של דבר להשתמש באפשרות שפחות תואמת לדרישות של המוצר. נכון ל2023/2024 אנו מאמינים כי ארבעת הפריימוורקים הללו הם הכדאיים ביותר להשוואה: [Nest.js](https://nestjs.com/), [Fastify](https://www.fastify.io/), [express](https://expressjs.com/), ו [Koa](https://koajs.com/). לחצו על לקריאה נוספת בהמשך כדי לקרוא פרטים נוספים בעד ונגד כל אחת מהאפשרויות. באופן פשטני, אנו מאמינים כי Nest.js זאת ההתאמה הכי טובה לצוותים שרוצים לעבוד בשיטת תכנות מונחה עצמים או לבנות מוצרים שמיועדים לגדול בצורה ניכרת ואי אפשר לחלק אותם לרכיבים קטנים _ועצמאיים_. ההמלצה שלנו היא Fastify עבור מערכות בעלות רכיבים בגודל סביר (כמו Microservices) שמושתתים על עקרונות פשוטים של Node.js. + **אחרת:** בשל הכמות העצומה של השיקולים, קל לקבל החלטה על בסיס מידע חלקי ולהשוות תפוחים לתפוזים. למשל, ישנה הנחה רווחת שFastify הוא web-server מינימלי שראוי להשוות לexpress בלבד. בפועל, זהו פריימוורק עשיר עם הרבה הרחבות רשמיות שמכסות הרבה צרכים.