Перейти до вмісту
EngineerПлатформа
Меню
Дизайн
Українська

Engineer / Платформа / Портфоліо

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

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

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

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

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

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

Контакти

Ще визначаєтесь, що саме вам потрібно?

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

Від 1 400 DKK за годину, без ПДВ — і дешевша година на довшому замовленні.

welcome@engineer.company +45 50 10 61 84 Копенгаген, Данія