Chrisad Δημοσ. 16 Μαΐου 2003 Δημοσ. 16 Μαΐου 2003 Why don't Java developers spend more time fixing their code instead of writing pointless comments? By Dr. Heinz Kabutz don't like comments. They are often so useless that I usually don't read them. Ever since my older brother caught me typing REM statements into a program as a child and then broke the news to me that they did absolutely nothing, I've developed a keen distrust of comments. This opinion only solidified when I pursued my computer science degree. I realized that my classmates and I wrote comments only to earn good marks from mean-spirited instructors who were more concerned with whether our code was commented than whether it worked correctly! Simply put, I felt that comments were a waste of time. My dislike of comments is based on the following reasoning: In most cases, comments are written by programmers who don't believe in them. Comments rarely reflect what is really happening in the code. Well-written code should not need comments. Of course, there are exceptions. For example, interfaces need very detailed comments to define the various conditions. If you have methods named f(), g(), and h(), you will need to document what the methods do. But why not call them something sensible in the first place? Instead of writing long pre- and post-conditions in the comments, why not write extensive unit tests? Το Τεκμηριώνει πάντως <img src="http://www.insomnia.gr/ubbthreads/images/graemlins/smile.gif" alt="" />:)
Billman Δημοσ. 16 Μαΐου 2003 Δημοσ. 16 Μαΐου 2003 Αυτό που λέει για τα σχόλια και τους καθηγητές είναι κάτι το οποίο ισχύει και μου την δίνει στα νεύρα... sigh...
apoc Δημοσ. 16 Μαΐου 2003 Δημοσ. 16 Μαΐου 2003 χεεχεχεχ ...αυτο ειναι λιγο παλιο..το ειχε γραψει περσυ! Προσωπικα πιστευω (εστω και με μια δoση κακιας) ο τυπος εχει δικιο σε καποιο βαθμο! Comments ξεχασμενα απο εδο και απο εκει, μερικες φορες (ιδιαιτερα σε φοιτητικα Project) τοσα πολλα που ειναι κουραστικά, μερικες φορες σε μπερδευουν πιο πολυ..γιατι ενα κομματι κωδικα εχει περαστει απο περισσοτερους απο εναν προγραμματιστες. Παρολα αυτα αυτο που λεει ειναι αστειο. Δεν θελω comments . ειναι αδιανοητο, γιατι πολυ απλα δεν μπορει να εφαρμοστει σε μεγαλα project με χιλιαδες γραμμες κωδικα..και με εκατονταδες ατομα να γραφουν κομματια απο εδω και απο εκει! Ta comments θελουμε δεν θελουμε βοηθανε σε καποιο βαθμο στην συντηρηση του κωδικα αλλα και την εξελιξη του. Καποιοι υποστηριζουν το εξης: ενας σωστα και καλα γραμμενος κωδικας δεν χρειαζεται σχολια, μιλαει απο μονος του! Και ρωτω..ποιος μπορει να υποστηριξει απολυτα οτι αν οχι ολες του οι δουλεις αλλα οι περισσοτερες ειναι τοσο καλα γραμμενες σε σημειο που ο κωδικας μιλαει απο μονος του ακομα και στα δυσκολα σημεια <img src="http://www.insomnia.gr/ubbthreads/images/graemlins/smile.gif" alt="" />
mkst Δημοσ. 17 Μαΐου 2003 Δημοσ. 17 Μαΐου 2003 so that's what idx meant! I thought it was an abbreviation of "idiots do XML loooool <img src="http://www.insomnia.gr/ubbthreads/images/graemlins/smile.gif" alt="" /> Συμφωνοι, ισως οι java programmers δεν ειχαν καμια καλυτερη δουλεια να κανουν....από την αλλη ομως διαφωνώ για την χρησιμοτητα των σχολιων....Πιστεύω οτι τα σχόλια είναι πολύ χρήσιμα, ιδιαιτερα οταν ο κώδικας προκειται να περάσει στα χέρια άλλου, ή όταν μετά από καιρό προσπαθήσεις να κανεις παρεμβάσεις. Δεν ειναι λιγες οι φορες που δεν καταλαβαινω τι ήθελα να κάνω ή τι σκεφτόμουν την στιγμή που έγραφα το συγκεκριμένο σημείο....εκεί μια αράδα λέξεων πάντα βοηθάει...
JPG Δημοσ. 17 Μαΐου 2003 Δημοσ. 17 Μαΐου 2003 Τελικά δεν είμαι μόνος μου σε αυτό τον πλανίτη. <img src="http://www.insomnia.gr/ubbthreads/images/graemlins/laugh.gif" alt="" /> Πολύ σπάνια βάζω σχόλια και ακόμα ποιο σπάνια κενές γραμμές. Θέλω ο κώδικάς μου να είναι όσο το δυνατόν πιο συμπαγής. Σε ενα αντικειμενοστραφές πρόγραμμα, όταν η δομή είναι καλή, το μέγεθος των μεθόδων είναι πολύ μικρό συνήθως. ʼρα μέσα σε μια μέθοδο 15-20 γραμών είναι παράλογο να βάλεις σχόλια. Τώρα το να βάλεις σχόλιο έξω απο την μέθοδο για να περιγράψεις το τι κάνει...αυτό πρέπει να το κάνεις με το όνομά της. Συμφωνώ απόλυτα λοιπον! <img src="http://www.insomnia.gr/ubbthreads/images/graemlins/smile.gif" alt="" />
Γηρυόνης Δημοσ. 17 Μαΐου 2003 Δημοσ. 17 Μαΐου 2003 Όσοι δεν τους αρέσουνε τα σχόλια μάλλον δεν έχουνε δουλέψει ακόμα στη ζωή τους... Στο πανεπιστήμιο ελάχιστα μπορώ να πω χρειάζονται αλλά αν ποτέ δουλέψεις και έχεις να κοιτάξεις χιλιάδες γραμμές κώδικα, να τον καταλάβεις και να τον αλλάξεις τότε θα καταλάβετε πόσο χρήσιμα είναι.
bandito Δημοσ. 17 Μαΐου 2003 Δημοσ. 17 Μαΐου 2003 Βέβαια υπάρχει και το άλλο άκρο, όπου υπαρχουν σχόλια του τύπου (τα εχω δεί με τα μάτια μου) counter++; //increase counter by 1. Τις περισσότερες φορές πάντως, και όταν το project δεν αγγίζει τα όρια του τεράστιου όπως αναφέρει ο Γηρυόνης, μια περιγραφή της μεθόδου ειναι αρκετή. Πάρτε και αυτό, το έχω κάνει post και πιο παλιά, ειναι ψιλοσχετικό και έχει πλάκα. How to write unmaintainable code
Προτεινόμενες αναρτήσεις
Αρχειοθετημένο
Αυτό το θέμα έχει αρχειοθετηθεί και είναι κλειστό για περαιτέρω απαντήσεις.