Τι σημαίνουν τα κρυμμένα σχόλια του Github;

Είστε νέοι στο Github ή / και συμβάλλετε σε έργα ανοιχτού κώδικα; Έχετε δει σύντομα μηνύματα όπως LGTM, ACK, NACK κ.λπ. και αναρωτιέστε τι εννοούν;

Ορίστε:

  • LGTM - μου φαίνεται καλό
  • ACK - αναγνώριση , δηλ. Συμφωνημένη / αποδεκτή αλλαγή
  • NACK / NAK - αρνητική αναγνώριση , δηλαδή διαφωνώ με την αλλαγή ή / και την έννοια
  • RFC - αίτημα για σχόλια, δηλαδή νομίζω ότι είναι καλή ιδέα, ας συζητήσουμε
  • WIP - οι εργασίες σε εξέλιξη, δεν συγχωνεύονται ακόμη
  • AFAIK / AFAICT - όσο γνωρίζω / μπορώ να πω
  • IIRC - αν θυμάμαι σωστά
  • IANAL - «Δεν είμαι δικηγόρος», αλλά μυρίζω προβλήματα αδειοδότησης

Πολλά έργα στην κρυπτογραφική χώρο επίσης να χρησιμοποιήσετε την ακόλουθη ( διαδόθηκε από Bitcoin είναι χάκερ διάλεκτος ):

  • Concept ACK - συμφωνείτε με την ιδέα, αλλά δεν έχετε ελέγξει τις αλλαγές
  • utACK (γνωστός και ως Untested ACK) - συμφωνήστε με τις αλλαγές και τις αξιολογήσατε, αλλά δεν το δοκιμάσατε
  • Δοκιμασμένο ACK - συμφωνήστε με τις αλλαγές, ελέγχθηκαν και δοκιμάστηκαν

Αυτές οι απαντήσεις είναι συνήθως μέρος της διαδικασίας αναθεώρησης κώδικα και θα τις βρείτε σε ζητήματα ή ζητήματα έλξης στο Github.

Τιμητική αναφορά: +1 ως η σύντομη μορφή του ACK (και σε πολλές περιπτώσεις, Concept ACK). Μετά την περίφημη επιστολή «Αγαπητέ Github», η πλατφόρμα εισήγαγε τις κατάλληλες αντιδράσεις στα σχόλια. Όχι, δεν πρόκειται να κάνουμε το Github το επόμενο Facebook :)

Θα δείτε επίσης τα ACK να περιλαμβάνονται σε μηνύματα δέσμευσης, όπως πώς το κάνει ο πυρήνας Linux από τότε που χρησιμοποιείται το Git:

Add get_random_long().Signed-off-by: Daniel Cashman Acked-by: Kees Cook Cc: "Theodore Ts'o" Cc: Arnd Bergmann Cc: Greg Kroah-Hartman Cc: Catalin Marinas Cc: Will Deacon Cc: Ralf Baechle Cc: Benjamin Herrenschmidt Cc: Paul Mackerras Cc: Michael Ellerman Cc: David S. Miller Cc: Thomas Gleixner Cc: Ingo Molnar Cc: H. Peter Anvin Cc: Al Viro Cc: Nick Kralevich Cc: Jeff Vander Stoep Cc: Mark Salyzyn Signed-off-by: Andrew Morton Signed-off-by: Linus Torvalds 

Ανατρέξτε στον οδηγό "Πώς να κάνετε την αλλαγή σας στον πυρήνα Linux" για μια λεπτομερή εξήγηση.

Παρόμοιες σύντομες απαντήσεις χρησιμοποιούνται ευρέως στη μηχανική λογισμικού και στην κοινότητα ανοιχτού κώδικα καθώς καθιστούν την επικοινωνία πιο αποτελεσματική.

Σίγουρα έχετε δει τα ακόλουθα στον πηγαίο κώδικα - TODO, FIXME, XXX και NOTE - και αναρωτήσατε μόνο τι σημαίνει XXX ;

Ενδιαφέρεστε να δείτε πολύ περισσότερα ακρωνύμια με εξήγηση και ίσως λίγο ιστορία; Δείτε το αρχείο Jargon. Είναι η οριστική πηγή από το 1975.

Trivia μπόνους : από πού προέρχεται το ACK / NACK;

Θα έλεγα ότι προήλθε από πρωτόκολλα δικτύωσης / διεπαφής, ίσως η δημοτικότητα του TCP προκάλεσε ευρεία χρήση.

SYN, SYN / ACK, ACK, FIN, ACK, FIN, ACK.