Що означають загадкові коментарі Github?

Ви новачок у Github та / або берете участь у проектах з відкритим кодом? Ви бачили короткі повідомлення, такі як LGTM, ACK, NACK тощо, і думали, що вони означають?

Ось:

  • LGTM - мені добре виглядає
  • ACK - підтвердження , тобто погоджена / прийнята зміна
  • NACK / NAK - негативне підтвердження , тобто незгода зі змінами та / або концепцією
  • RFC - запит на коментарі, тобто, я думаю, це гарна ідея, дозволяє обговорити
  • WIP - незавершене виробництво, поки не об’єднуйтесь
  • AFAIK / AFAICT - наскільки я знаю / можу сказати
  • IIRC - якщо я правильно згадую
  • IANAL - "Я не юрист", але відчуваю запах питань ліцензування

Багато проектів в криптографічного просторі також використовують наступне ( популяризував на Bitcoin в хакерській жаргоні ):

  • Концепція ACK - погоджуйтесь з концепцією, але не переглядали зміни
  • utACK (він же Неперевірений ACK) - погоджуйтесь зі змінами та переглядайте їх, але не тестували
  • Перевірений ACK - погодитись із змінами, переглянутими та протестованими

Ці відповіді зазвичай є частиною процесу перегляду коду, і ви знайдете їх у запитаннях або запитах у Github.

Почесна згадка: +1 як коротка форма ACK (і в багатьох випадках концепція 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 ?

Хочете побачити набагато більше скорочень із поясненнями і, можливо, трохи історії? Перегляньте файл жаргону. Це остаточне джерело з 1975 року.

Бонусні дрібниці : звідки походить ACK / NACK?

Я б сказав, що це походить від мережевих / інтерфейсних протоколів, можливо, популярність TCP спричинила широке використання.

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