תיעוד אינפוט מיוחד

תגיות:

היי!
אם אני רוצה שהאינפוט יהיה מוגבל לטייפ מיוחד מסויים, איך כותבים זאת בתיעוד של הארגומנטים?
סגנון גוגל.
להלן שתי דוגמאות שלא הצלחתי להבין אם כתיבתן נכונה:

image

תודה!!

מה הטייפ של הדוגמאות ששמת בסוגריים?

מה שכתבתי.
הראשון פשוט מופע
השני נובע ממודול

בראשון: פשוט Player
חוץ מזה אחלה

תודה!

בהמשך לאותה שאלה -
במחברות ראיתי שכשאחד הפרמטרים הוא ליסט, אז כותבים ליסט בתיעוד. אבל לא מפורטים שם סוגי האיברים בליסט. לא מקובל להוסיף את סוגי האיברים גם לתיעוד? אחרת המשתמש החיצוני יאלץ לחקור את הקוד

מקובל: list of str נניח

2 לייקים