Uber Go Style Guide — Русская версия

🇷🇺 Актуальный и поддерживаемый русский перевод официального Uber Go Style Guide.

📌 Перевод основан на версии оригинала: uber-go/guide @ e2c8a0ed

---

📖 О проекте

Это современный русский перевод Uber Go Style Guide — авторитетного руководства по написанию идиоматичного Go-кода от команды Uber.

Почему новый перевод?

Существующий перевод (sau00/uber-go-guide-ru) не обновлялся с 22 ноября 2020 года. За более чем 5 лет оригинальное руководство значительно изменилось.

📊 Что изменилось в оригинале:

• 84 новых коммита с момента последнего обновления старого перевода
• Новые разделы:
  • Управление жизненным циклом горутин (goroutine-exit.md, goroutine-forget.md) — 2022
  • Обработка ошибок только один раз (error-once.md) — 2023
  • Расширенные рекомендации по табличным тестам — 2023
  • Теги полей в маршалируемых структурах (struct-tag.md) — 2022
• Обновлённые рекомендации:
  • Работа с ошибками: переход на %w, errors.Is(), errors.As()
  • Линтинг: переход с устаревшего golint на современный revive
  • Примеры для Go 1.22+ с учётом новых возможностей языка

✨ Преимущества этого перевода:

• ✅ Актуальность: соответствует последней версии оригинала
• ✅ Качество: профессиональный перевод с сохранением технической точности
• ✅ Консистентность: единообразная терминология через весь документ
• ✅ Полнота: все 58 файлов переведены, включая новые разделы
• ✅ Поддержка: планируется синхронизация с будущими обновлениями оригинала

---

📚 Документация

Структура проекта

uber-go-guide-ru/
├── src/              # Исходные файлы перевода
│   ├── SUMMARY.md    # Оглавление
│   ├── intro.md      # Введение
│   ├── panic.md      # Не используйте panic
│   └── ...           # Остальные разделы (в процессе перевода)
└── README.md         # Этот файл

Читайте отдельные разделы в директории src/ или используйте оглавление src/SUMMARY.md.

---

🚀 Статус перевода

✅ Перевод завершён! Все 58 файлов переведены на русский язык.

📊 Подробная статистика: TRANSLATION_PROGRESS.md

---

📝 Лицензия

Этот перевод распространяется под той же лицензией, что и оригинальное руководство.

Оригинал: © Uber Technologies, Inc.

---

🔗 Ссылки

• 📘 Оригинальное руководство: uber-go/guide
• 🇷🇺 Этот перевод: alekarah/uber-go-guide-ru
• 💬 Обсуждения и вопросы: Issues

---

Поддержите проект: Поставьте ⭐️ если этот перевод оказался полезным!