aboutsummaryrefslogtreecommitdiff
path: root/docs/he-il/documentation_best_practices.md
diff options
context:
space:
mode:
authorGuy Khmelnitsky <guykhmel@gmail.com>2019-10-31 11:47:07 +0200
committernoroadsleft <18669334+noroadsleft@users.noreply.github.com>2019-10-31 02:47:07 -0700
commit742e83e102f5d91087672ae3f91e433a74bd51dd (patch)
treee62c4477ef3018850dd59d246a0ed8e5ab4c600d /docs/he-il/documentation_best_practices.md
parent934fa5183e95ad98e2e744c48e524308e940f799 (diff)
downloadqmk_firmware-742e83e102f5d91087672ae3f91e433a74bd51dd.tar.gz
qmk_firmware-742e83e102f5d91087672ae3f91e433a74bd51dd.zip
[Docs] Add he-IL (Hebrew) Translation (#7001)
* Add he-IL (Hebrew) Translation * Add Hebrew to SUMMARY * Try RTL * Add RTL text * Lowercase folder names * Update lowercase folder in Summary * Adding getting_started_introduction.md * Add Proton C Conversion translation * Add Becoming a QMK Collaborator Translation * Add FAQ translation * Add Hardware translation * Documentation Best Practices translation * Add FAQ General translation * Align docs RTL * Add Becoming a QMK Collaborator Translation * Translate Getting Started - Getting Help * Translate Getting Started With Github * Code sections should be alligned to the left * Code sections should be alligned to the left * Code sections should be alligned to the left * Revert "Code sections should be alligned to the left" This reverts commit d0c46e90c4915ceebe7c5182aca2b75afad25df0. * Add Markdown aligned to the left * Update quantum_keycodes.md * Update proton_c_conversion.md * Translate Newbs Learn More Resourses
Diffstat (limited to 'docs/he-il/documentation_best_practices.md')
-rw-r--r--docs/he-il/documentation_best_practices.md67
1 files changed, 67 insertions, 0 deletions
diff --git a/docs/he-il/documentation_best_practices.md b/docs/he-il/documentation_best_practices.md
new file mode 100644
index 000000000..90c4a137a
--- /dev/null
+++ b/docs/he-il/documentation_best_practices.md
@@ -0,0 +1,67 @@
1<div dir="rtl" markdown="1">
2# איך לתעד נכון
3
4עמוד זה קיים כדי לתעד את השיטות הטובות ביותר כאשר כותבים תיעוד עבור QMK. מעקב אחר הוראות אלה יעזור לשמור על סגנון וטון עקביים, אשר בתורם יעזרו לאנשים אחרים להבין טוב יותר את QMK.
5
6# פתיחת עמוד
7
8התיעוד שלך צריך בד״כ להפתח עם כותרת בגודל H1, אחריה פסקה אחת של תיאור של מה המשתמש ימצא בעמוד זה.
9זכור כי כותרת זו והפסקה ימוקמו ליד תוכן העניינים, אז חשוב לשמור על כותרת קצרה ולהמנע ממשפטים ארוכים ללא פיסוק.
10
11לדוגמה:
12
13```
14# הכותרת שלי
15
16עמוד זה מדבר על היכולת הסופר-מגניבה שלי. אתה יכול להשתמש ביכולת זו כדי להכין קפה, לסחוט תפוזים ולקבל משלוח של ביצים ועוגות מהסופר הקרוב באמצעות רחפן.
17```
18
19# כותרות
20
21עמוד התיעוד צריך לאופן כללי לכלול מס׳ כותרות בגודל "H1". רק כותרות מגודל H1 ו- H2 יכללו בתוכן העניינים, אז חשוב לתכנן אותם בהתאם. הכותרות לא להיות רחבות מידי כדי למנוע מתוכן העניינים להפוך להיות רחב מידי
22
23# בלוקי רמיזה מעוצבים
24
25ניתן להוסיף בלוקי רמיזה מעוצבים שמצויירים מסביב לטקסט כדי למשוך תשומת לב אליו.
26
27### חשוב
28
29```
30!> זה חשוב
31```
32
33יתרנדר כ:
34
35!> זה חשוב
36
37### טיפים כלליים
38
39```
40?> זהו טיפ שימושי.
41```
42
43יתרנדר כ:
44
45?> זהו טיפ שימושי.
46
47
48# תיעוד יכולות ופיצ׳ריםDocumenting Features
49
50אם יוצרים יכולת חדשה ב QMK, צרו עמוד תיעוד עבורה. העמוד לא צריך להיות ארוך במיוחד, מספר משפטים המתארים את היכולת (פיצ׳ר) וטבלה המתארת קודי מקשים רלוונטיים זה מספיק. הנה דוגמה בסיסית:
51
52```markdown
53# הפיצ׳ר המגניב שלי
54
55עמוד זה מדבר על היכולת הסופר-מגניבה שלי. אתה יכול להשתמש ביכולת זו כדי להכין קפה, לסחוט תפוזים ולקבל משלוח של ביצים ועוגות מהסופר הקרוב באמצעות רחפן.
56
57## קודי המקשים המגניבים של היכולת שלי
58
59|Long Name|Short Name|Description|
60|---------|----------|-----------|
61|KC_COFFEE||Make Coffee|
62|KC_CREAM||Order Cream|
63|KC_SUGAR||Order Sugar|
64```
65
66מקמו את התיעוד שלכם בתוך `docs/feature_<my_cool_feature>.md`, והוסיפו קישור לקובץ זה במקום המתאים ב `docs/_sidebar.md`. אם הוספתם קודי מקשים נוספים, תקפידו להוסיף אותם ל- `docs/keycodes.md` עם לינק לעמוד היכולת שלכם.
67</div> \ No newline at end of file