Mida tähendavad krüptilised Githubi kommentaarid?

Kas olete Githubi uus kasutaja ja / või osalete avatud lähtekoodiga projektides? Kas olete näinud lühisõnumeid nagu LGTM, ACK, NACK jne ja mõelnud, mida need tähendavad?

Palun:

  • LGTM - näeb minu jaoks hea välja
  • ACK - kinnitus , st kokkulepitud / aktsepteeritud muudatus
  • NACK / NAK - negatiivne kinnitus , st ei nõustu muudatuste ja / või kontseptsiooniga
  • RFC - kommentaaride taotlus, st ma arvan, et see on hea mõte, võimaldab arutada
  • WIP - töö on pooleli, ei ühenda veel
  • AFAIK / AFAICT - minu teada / oskan öelda
  • IIRC - kui ma õigesti mäletan
  • IANAL - "Ma ei ole jurist", aga ma tunnen litsentside probleeme

Paljud krüptoruumis olevad projektid kasutavad ka järgmist ( Bitcoini häkkerilingo poolt populariseeritud ):

  • Mõiste ACK - nõustuge kontseptsiooniga, kuid pole muudatusi üle vaadanud
  • utACK (aka. Testimata ACK) - nõustuge muudatustega ja vaatasite need üle, kuid ei testinud
  • Testitud ACK - nõustu muudatustega, vaadatud üle ja testitud

Need vastused on tavaliselt osa koodi ülevaatamise protsessist ja leiate need Githubi väljaannetest või päringutest .

Aumärkus: +1 kui ACK (ja paljudel juhtudel ka Concept ACK) lühivorm. Pärast kuulsat “Kallis Githubi” kirja on platvorm tutvustanud kommentaatoritele korralikke reaktsioone. Ei, see ei tähenda Githubi muutmist teie järgmiseks Facebookiks :)

Samuti näete, et ACK-d lisatakse pühendussõnumitesse, näiteks kuidas Linuxi kernel seda teeb, kuna Gitit kasutatakse:

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 

Põhjaliku selgituse saamiseks vaadake juhendit "Kuidas oma muudatused Linuxi kernelisse viia".

Sarnaseid lühivastuseid kasutatakse laialdaselt tarkvaratehnikas ja avatud lähtekoodiga kogukonnas, kuna need muudavad suhtluse tõhusamaks.

Olete kindlasti lähtekoodis näinud järgmist - TODO, FIXME, XXX ja NOTE - ja mõelnud ainult, mida tähendab XXX ?

Kas soovite näha palju rohkem lühendeid koos selgituste ja võib-olla natuke ajalooga? Tutvuge nimetussõnaga. See on lõplik allikas alates 1975. aastast.

Boonuse tühiasi : kust ACK / NACK pärineb?

Ma ütleksin, et see tuli võrgu- / liideseprotokollidest, võib-olla põhjustas TCP populaarsus laialdast kasutamist.

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