בעיקרון, בד"כ לא מתעדים ככה....
אבל, זה משהו שמזכרוני (בתקופה שלמדתי בבי"ס) דרשו אותו במערכת החינוך. הכוונה היא שתפתח בלוק אחרי שורת הצהרה של הפונקציה, ותגיד מה הקלט שיכנס לפונקציה ומה אתה מניח עליו (תקינות, פורמט וכו') וטענת יציאה (כלומר מה אמור לצאת בהחזרה).