לוגו אתר Fresh          
 
 
  אפשרות תפריט  ראשי     אפשרות תפריט  צ'אט     אפשרות תפריט  מבזקים     אפשרות תפריט  צור קשר     חץ שמאלה ‎print ‎"Hello World!"; if‎ ‎not rules.‎know ‎then rules.‎read();‎ חץ ימינה  

לך אחורה   לובי הפורומים > מחשבים > תכנות ובניית אתרים
רענן עמוד זה צריך את עזרתם בנושא הזחה ותיעוד של קוד
שמור לעצמך קישור לדף זה באתרי שמירת קישורים חברתיים
תגובה
« לאשכול הקודם | לאשכול הבא »
 
כלי אשכול חפש באשכול זה



  #1  
ישן 07-08-2005, 19:29
צלמית המשתמש של bazooka joe
  bazooka joe bazooka joe אינו מחובר  
 
חבר מתאריך: 16.07.02
הודעות: 6,814
Facebook profile
עזרה צריך את עזרתם בנושא הזחה ותיעוד של קוד
בעקבות ויכוחון קטן עם אלכס, אני פותח אשכות בנושא של הזחה ותיעוד של קוד.

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

עכשיו אתם...
_____________________________________
תמונה שהועלתה על ידי גולש באתר ולכן אין אנו יכולים לדעת מה היא מכילה

נערך לאחרונה ע"י bazooka joe בתאריך 07-08-2005 בשעה 19:33.
תגובה ללא ציטוט תגובה עם ציטוט חזרה לפורום
  #2  
ישן 07-08-2005, 19:52
צלמית המשתמש של kukURIku
  kukURIku kukURIku אינו מחובר  
 
חבר מתאריך: 07.09.02
הודעות: 17,302
שלח הודעה דרך MSN אל kukURIku
א. השיטה ההונגרית היא סבבה
בתגובה להודעה מספר 1 שנכתבה על ידי bazooka joe שמתחילה ב "צריך את עזרתם בנושא הזחה ותיעוד של קוד"
ב. המדד הכי טוב לתיעוד הקוד היא הבנתו על ידי אחרים. לא רק עצמך.
ג. אני נוהג להוסיף גם הערות JAVADOC עם פירוט מדויק מה פונקציה עושה, מקבלת, מחזירה וזורקת. זה מאפשר גם לזכור ולהבין יותתר טוב בעצמי מה כתבתי לפני חודש. גם נוח כי זה מקפיץ TOOLTIP ב-ECLIPSE, וגם ניתן ליצור קבצי DOC ממש.
ד. תיעוד פנימי - אני נוהג לעשות את זה בשיטת הLOG כלומר, במקום לכתוב הערות (זה אני עושה מעט ורק אם באמת צריך להסביר משהו) ובעיקר כותב ל-LOG ב-DEBUG ומה שעיקרי יותר אז ב-INFO
_____________________________________
חתימתכם הוסרה כיוון שלא עמדה בחוקי האתר. לפרטים נוספים לחצו כאן.

תגובה ללא ציטוט תגובה עם ציטוט חזרה לפורום
  #3  
ישן 07-08-2005, 19:58
צלמית המשתמש של bazooka joe
  bazooka joe bazooka joe אינו מחובר  
 
חבר מתאריך: 16.07.02
הודעות: 6,814
Facebook profile
תודה...
בתגובה להודעה מספר 2 שנכתבה על ידי kukURIku שמתחילה ב "א. השיטה ההונגרית היא סבבה"
לגבי התיעוד של הפונקציות, אתה מפרט גם את הדרך של הפונקצייה?
_____________________________________
תמונה שהועלתה על ידי גולש באתר ולכן אין אנו יכולים לדעת מה היא מכילה

תגובה ללא ציטוט תגובה עם ציטוט חזרה לפורום
  #4  
ישן 07-08-2005, 20:14
צלמית המשתמש של kukURIku
  kukURIku kukURIku אינו מחובר  
 
חבר מתאריך: 07.09.02
הודעות: 17,302
שלח הודעה דרך MSN אל kukURIku
לא.
בתגובה להודעה מספר 3 שנכתבה על ידי bazooka joe שמתחילה ב "תודה..."
JAVADOC בעצם מספק API. למי שקורה אותו - אין צורך לדעת איך זה זה קורה בפנים אלא מה זה עושה.
איך - זה ההערות המועטות שאני כותב. בנוסף לכתיבה לLOG שהיא חלק מתיעוד.
אצלי בממוצע על כל 4-5 שורות קוד יש שורת LOG, ככה שהכל די ברור גם אם קוראים ומתקנים אחרי חודשים

אם אתה עובד בעיק בCPP אז יש גם http://logging.apache.org/log4cxx/
מומלץ מאוד
_____________________________________
חתימתכם הוסרה כיוון שלא עמדה בחוקי האתר. לפרטים נוספים לחצו כאן.

תגובה ללא ציטוט תגובה עם ציטוט חזרה לפורום
  #5  
ישן 07-08-2005, 20:06
צלמית המשתמש של hmemcpy
  hmemcpy hmemcpy אינו מחובר  
 
חבר מתאריך: 23.11.03
הודעות: 4,041
בתגובה להודעה מספר 2 שנכתבה על ידי kukURIku שמתחילה ב "א. השיטה ההונגרית היא סבבה"
עוד כלי מעולה לתעוד בסביבת NET.:
http://ndoc.sourceforge.net
תגובה ללא ציטוט תגובה עם ציטוט חזרה לפורום
  #6  
ישן 07-08-2005, 20:15
צלמית המשתמש של kukURIku
  kukURIku kukURIku אינו מחובר  
 
חבר מתאריך: 07.09.02
הודעות: 17,302
שלח הודעה דרך MSN אל kukURIku
נחמד :-}
בתגובה להודעה מספר 5 שנכתבה על ידי hmemcpy שמתחילה ב "עוד כלי מעולה לתעוד בסביבת..."
אני נשאר עם ECLIPSE ו-JAVADOC (למרות הכל ולשביעות רצוני )
_____________________________________
חתימתכם הוסרה כיוון שלא עמדה בחוקי האתר. לפרטים נוספים לחצו כאן.

תגובה ללא ציטוט תגובה עם ציטוט חזרה לפורום
  #7  
ישן 07-08-2005, 20:37
צלמית המשתמש של hmemcpy
  hmemcpy hmemcpy אינו מחובר  
 
חבר מתאריך: 23.11.03
הודעות: 4,041
בתגובה להודעה מספר 6 שנכתבה על ידי kukURIku שמתחילה ב "נחמד :-}"
אני משלב בין Eclipse ל- Source Insight בשביל שליטה מלאה בקוד.

אחח.. אם היה אפשר לעבוד בג'אווה (ולא #J) ב- IDE של VS2005...
תגובה ללא ציטוט תגובה עם ציטוט חזרה לפורום
  #8  
ישן 07-08-2005, 21:02
צלמית המשתמש של kukURIku
  kukURIku kukURIku אינו מחובר  
 
חבר מתאריך: 07.09.02
הודעות: 17,302
שלח הודעה דרך MSN אל kukURIku
אהבתי :}
בתגובה להודעה מספר 7 שנכתבה על ידי hmemcpy שמתחילה ב "אני משלב בין Eclipse ל-..."
אך כיוון שעיקר השליטה באפליקציה שלנו נעשית דרך כלי יעודי אחר (לא יכול לציין). לנו אין צורך בכל התרשימי מחלקות וכו'. ה-ECLIPSE מספיק

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

תגובה ללא ציטוט תגובה עם ציטוט חזרה לפורום
  #9  
ישן 07-08-2005, 21:29
צלמית המשתמש של hmemcpy
  hmemcpy hmemcpy אינו מחובר  
 
חבר מתאריך: 23.11.03
הודעות: 4,041
בתגובה להודעה מספר 8 שנכתבה על ידי kukURIku שמתחילה ב "אהבתי :}"
חחח הצבעים כן
אבל אפשר לכבות את רוב הצביעות. אני משתמש ב- Source Insight בעיקר בגלל יכולות החזקה שלו של החיפוש בתוך קבצים.
תגובה ללא ציטוט תגובה עם ציטוט חזרה לפורום
  #10  
ישן 07-08-2005, 21:02
צלמית המשתמש של fat fish
  fat fish fat fish אינו מחובר  
 
חבר מתאריך: 20.06.03
הודעות: 5,616
בסביבת NET
בתגובה להודעה מספר 1 שנכתבה על ידי bazooka joe שמתחילה ב "צריך את עזרתם בנושא הזחה ותיעוד של קוד"
אני משתמש בשיטת התיעוד שלהם, שמייצרת קבצי XML.

בכל שאר הסביבות, אני משתמש בשיטה הנהוגה בפיתוח PHP, שהוגדר ע"י pear:
http://pear.php.net/manual/en/standards.php
_____________________________________
[ זיו ]
[ fat fish ]

תגובה ללא ציטוט תגובה עם ציטוט חזרה לפורום
  #11  
ישן 07-08-2005, 21:27
צלמית המשתמש של hmemcpy
  hmemcpy hmemcpy אינו מחובר  
 
חבר מתאריך: 23.11.03
הודעות: 4,041
בתגובה להודעה מספר 10 שנכתבה על ידי fat fish שמתחילה ב "בסביבת NET"
שתייצר LaTeX, אז נדבר
תגובה ללא ציטוט תגובה עם ציטוט חזרה לפורום
תגובה
« לאשכול הקודם | לאשכול הבא »

כלי אשכול חפש באשכול זה
חפש באשכול זה:

חיפוש מתקדם
מצבי תצוגה דרג אשכול זה
מצב כלאיים מצב כלאיים
דרג אשכול זה:

מזער את תיבת המידע אפשרויות משלוח הודעות
אתה לא יכול לפתוח אשכולות חדשים
אתה לא יכול להגיב לאשכולות
אתה לא יכול לצרף קבצים
אתה לא יכול לערוך את ההודעות שלך
קוד vB פעיל
קוד [IMG] פעיל
קוד HTML כבוי
מעבר לפורום



כל הזמנים המוצגים בדף זה הם לפי איזור זמן GMT +2. השעה כעת היא 13:10

הדף נוצר ב 0.04 שניות עם 12 שאילתות
צור קשר - Fresh - למעלה

הפורום מבוסס על vBulletin, גירסא 3.0.6
כל הזכויות לתוכנת הפורומים שמורות © 2024 - 2000 לחברת Jelsoft Enterprises.
כל הזכויות שמורות ל Fresh.co.il ©

צור קשר | תקנון האתר