Перейти до вмісту

Привела 4 репозиторії до одного стандарту історії

Привела чотири репозиторії до одного стандарту історії — conventional‑коміти, без емодзі, без рядків атрибуції, з контролем через хук повідомлень комітів, — поряд із 48 документами інструкцій, що визначають, як виконується робота.

48 документів з інструкціями щодо виконання роботи

Ситуація. Чотири репозиторії, які одна людина створила за вісімнадцять місяців, — саме та ситуація, коли процесом найлегше знехтувати: координуватися немає з ким, а за історію, яку неможливо прочитати, повністю розплачується та сама людина в майбутньому, яка поки що не скаржилася. Це також ситуація, у якій неузгоджена історія найімовірніша, бо кожен репозиторій може поступово обрости власними звичками, і ніщо не зводить їх до спільного знаменника.

Завдання. Один стандарт для історії та один стандарт для інструкцій мали діяти в кожному репозиторії, де ведеться робота, і їхнє дотримання треба було забезпечити автоматично, а не покладатися на пам’ять.

Дія. Стандарт комітів такий: конвенційний префікс, що вказує тип зміни, та область, тема не довша за фіксовану довжину, жодних емодзі й жодних рядків атрибуції будь‑якого роду — останнє тому, що рядок, який приписує заслугу інструментові, — це не факт про зміну, а історія існує для фактів про зміни. Хук для повідомлень комітів відхиляє все, що не відповідає стандарту, у кожному репозиторії, де ведеться робота, тож стандарт — властивість репозиторію, а не того, хто робить коміт. Розподіл у найбільшому репозиторії показує, з чого насправді складалася робота: 156 комітів — нові функції, 133 — виправлення, 128 — документація, 81 — допоміжні завдання, 26 — рефакторинг, 20 — стиль, 5 — продуктивність і 3 — тести. Документація настільки близька до виправлень, що це варто помітити, і це наслідок другої половини роботи — 48 документів з інструкціями в чотирьох репозиторіях: кожен охоплює одну область, кожен написано як набір правил, а не як опис, і всі доступні з єдиного вхідного документа в кожному репозиторії, тож почати завжди можна з одного місця. Лінтер документації контролює ліміти розміру для кожного файлу та наявність файлу в індексі, тож набір документів лишається зручним для навігації, а не розростається в архів.

Результат. Чотири репозиторії мають спільний формат історії та спільну структуру інструкцій, і дотримання обох забезпечують хуки, а не дисципліна. Доброю історію це не робить: формат перевіряється, а зміст — ні, тож тема, що відповідає формату, але нічого не описує, проходить так само успішно, як та, що пояснює зміну.

  • Старі книги, книжкова полиця
    Фото: 4262159 / Pixabay
  • Аудит, бухгалтерський облік, бухгалтерська книга
    Фото: Tumisu / Pixabay

Застосуйте цей досвід у своєму проєкті

Використайте «Привела 4 репозиторії до одного стандарту історії» як відправну точку для схожого завдання у вашій організації. Послуги, що стоять за цією роботою, доступні й для вашого проєкту. Хтось на вашому боці столу, коли підрядник, бюджет або архітектурне рішення потребують кваліфікованої оцінки.

Переглянути наші послуги Зв'язатися з нами

Дізнайтеся, що привело до результату

Прочитайте про ситуацію, рішення та результат цього прикладу. Ми можемо обговорити, що відповідає вашим умовам, а що потребує іншого підходу. Привела 4 репозиторії до одного стандарту історії — 48 документів з інструкціями щодо виконання роботи

Переглянути наші послуги Зв'язатися з нами

Одна частина довшого переліку — і він увесь на цьому сайті.

Кожен запис написано однаково: ситуація, завдання, що ми зробили і що змінилося.

Переглянути весь перелік

Визначте потрібне покращення

Опишіть рішення, людей, яких воно стосується, та вже розглянуті варіанти. Ми можемо явно показати компроміси й залишити документовану рекомендацію.

Дивитися, скільки це коштує Зв'язатися з нами

Хочете один стандарт, що діє в усіх репозиторіях?

Запитайте про рішення в роботі «Привела 4 репозиторії до одного стандарту історії». Ви говоритимете з людьми, які можуть пояснити роботу й оцінити ваш проєкт.

Переглянути наші послуги
welcome@engineer.company +45 50 10 61 84 Копенгаген, Данія
QR-код сторінки «Привела чотири репозиторії до одного стандарту історії — conventional‑коміти, без емодзі, без рядків атрибуції, з контролем через хук повідомлень комітів, — поряд із 48 документами інструкцій, що визначають, як виконується робота.»
Візьміть цю сторінку із собоюhttps://advisory.engineer.company/uk/portfolio/held-4-repositories-to-one-history-standard/