Što znače tajnoviti komentari na Githubu?

Jeste li novi u Githubu i / ili doprinosite li projektima otvorenog koda? Jeste li vidjeli kratke poruke poput LGTM, ACK, NACK itd. I pitate se što one znače?

Izvoli:

  • LGTM - izgleda mi dobro
  • ACK - potvrda , tj. Dogovorena / prihvaćena promjena
  • NACK / NAK - negativno priznanje , tj. Neslaganje s promjenom i / ili konceptom
  • RFC - zahtjev za komentarima, tj. Mislim da je ovo dobra ideja, dopuštamo raspravu
  • WIP - u tijeku, još se ne spajajte
  • AFAIK / AFAICT - koliko znam / mogu reći
  • IIRC - ako se dobro sjećam
  • IANAL - "Nisam odvjetnik", ali osjećam probleme s licencama

Mnogi projekti u kripto prostoru koriste i sljedeće ( popularizirano od Bitcoin-ovog hakerskog žargona ):

  • Koncept ACK - slažete se s konceptom, ali niste pregledali promjene
  • utACK (zvani i neprovjereni ACK) - složite se s promjenama i pregledali ih, ali niste testirali
  • Testirano ACK - složite se s izmjenama, pregledano i testirano

Ti su odgovori obično dio postupka pregledavanja koda i naći ćete ih u izdanjima ili povući zahtjeve u Githubu.

Počasno spominjanje: +1 kao kratki oblik ACK (i u mnogim slučajevima koncept ACK). Nakon čuvenog pisma "Dragi Github", platforma je uvela odgovarajuće reakcije na neuredne komentare. Ne, ovdje se ne radi o tome da Github postane vaš sljedeći Facebook :)

Također biste vidjeli da su ACK-ovi uključeni u poruke urezivanja, na primjer kako to radi Linux kernel, budući da se koristi 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 

Pogledajte vodič "Kako unijeti promjenu u Linux kernel" za detaljno objašnjenje.

Slični kratki odgovori široko se koriste u softverskom inženjerstvu i zajednici otvorenog koda jer čine komunikaciju učinkovitijom.

Sigurno ste vidjeli sljedeće u izvornom kodu - TODO, FIXME, XXX i NOTE - i samo se pitali što XXX znači?

Želite li vidjeti puno više kratica s objašnjenjem i možda malo povijesti? Pogledajte Datoteku žargona. Definitivni je izvor od 1975. godine.

Bonus trivijalnost : odakle dolazi ACK / NACK?

Rekao bih da dolazi iz mrežnih protokola / sučelja, možda je popularnost TCP-a uzrokovala široku upotrebu.

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