דף זה עוסק בהגשת בקשת משיכה המכילה קובצי תיעוד של Markdown אל tensorflow/tfhub.dev . GitHub Repo. למידע נוסף על איך לכתוב את קבצי Markdown מלכתחילה, עיין במדריך תיעוד הכתיבה .
בדיקות GitHub Actions
המאגר tensorflow/tfhub.dev משתמש ב-GitHub Actions כדי לאמת את הפורמט של הקבצים ב-PR. זרימת העבודה המשמשת לאימות PRs מוגדרת ב- .github/workflows/contributions-validator.yml . אתה יכול להריץ את סקריפט האימות בסניף משלך מחוץ לזרימת העבודה, אבל תצטרך לוודא שהתקנת את כל התלות הנכונות של חבילת ה-pip.
תורמים בפעם הראשונה יכולים להפעיל בדיקות אוטומטיות רק באישור של מנהל ריפו, לפי מדיניות GitHub . ממליצים לבעלי אתרים להגיש יח"צ קטן לתיקון שגיאות הקלדה, לשפר אחרת את תיעוד המודל, או להגיש יח"צ המכיל רק את דף המפרסם שלהם בתור היח"צ הראשון שלהם כדי להיות מסוגלים להריץ בדיקות אוטומטיות בפרסומים הבאים.
הגשת יחסי הציבור
ניתן למשוך את קובצי ה-Markdown המלאים לענף הראשי של tensorflow/tfhub.dev באחת מהשיטות הבאות.
הגשת Git CLI
בהנחה שנתיב קובץ הסימון המזוהה הוא assets/docs/publisher/model/1.md , אתה יכול לבצע את השלבים הסטנדרטיים של Git[Hub] כדי ליצור בקשת משיכה חדשה עם קובץ חדש שנוסף.
זה מתחיל במזלג של מאגר TensorFlow Hub GitHub, ולאחר מכן יצירת Pull Request מהמזלג הזה אל ענף המאסטר של TensorFlow Hub.
להלן פקודות CLI git טיפוסיות הדרושות להוספת קובץ חדש לענף מאסטר של מאגר המזלג.
git clone https://github.com/[github_username]/tfhub.dev.git
cd tfhub.dev
mkdir -p assets/docs/publisher/model
cp my_markdown_file.md ./assets/docs/publisher/model/1.md
git add *
git commit -m "Added model file."
git push origin master
הגשת ממשק המשתמש של GitHub
דרך קצת יותר פשוטה להגשה היא באמצעות ממשק המשתמש הגרפי של GitHub. GitHub מאפשר יצירת PRs עבור קבצים חדשים או עריכת קבצים ישירות דרך GUI.
- בדף TensorFlow Hub GitHub , לחץ על לחצן
Create new file. - הגדר את נתיב הקובץ הנכון:
assets/docs/publisher/model/1.md - העתק-הדבק את הסימון הקיים.
- בתחתית, בחר "צור סניף חדש עבור ההתחייבות הזו והתחל בקשת משיכה".