Jak unikać chaosu w Dynamo: 7 zasad, które działają po 6 miesiącach

Ten wpis otwiera serię notatek technicznych. Celem jest utrzymanie czytelnych grafów nawet po wielu iteracjach projektu.

1. Nazwy grup mówiące co i po co

Zamiast ogólnego "Inputs" i "Calc", stosuj wzorzec: sekcja + cel + efekt. Przykład: Walls | Filter by level | Output set.

2. Jedna odpowiedzialność na blok

Jeżeli grupa robi filtr, sortowanie i export jednocześnie, to po tygodniu nikt nie wie gdzie zacząć debugowanie. Rozdziel te etapy.

3. Zawsze zostawiaj ścieżkę testową

Po każdym etapie daj podgląd wyniku: liczba elementów, próbka listy, podstawowy sanity check. To skraca czas diagnozy.

4. Ogranicz ilość wejść globalnych

Za dużo sliderów i toggli na starcie szybko zabija stabilność. Trzymaj kluczowe parametry centralnie i opisuj ich zakres.

5. Wersjonuj graf jak kod

• v1.2.0 - nowa funkcja
• v1.2.1 - poprawka bugfix
• v2.0.0 - breaking change

6. Komentarze pisz pod przyszłego siebie

Nie opisuj oczywistości typu "sortuję listę". Opisuj ryzyko: dlaczego ten krok jest wrażliwy i co się zepsuje, jeśli dane są puste.

7. Changelog obok grafu

Trzymaj prosty changelog przy paczce. Kiedy wracasz po kwartale, to on daje kontekst i ogranicza niepotrzebne eksperymenty.

Podsumowanie

Największy zysk daje konsekwencja: jedna konwencja nazewnicza, jedna struktura, regularny changelog. Wtedy nawet duży graf pozostaje przewidywalny.