W oparciu o komentarz i kolejne opinie z Bug ponownie otwarte vs. nowe :
Powoływanie się na identyfikatory błędów w opisach poprawek jest po prostu… bardzo nieprzyjazne. - Krelp
Wydaje się, że przynajmniej niektórzy uważają, że odwoływanie się do identyfikatorów błędów w informacjach o łatach nie jest dobrym pomysłem. Jestem dość niedoświadczonym programistą, więc zastanawiam się, dlaczego tak jest.
issue-tracking
bug-report
software-patches
Travis Northcutt
źródło
źródło
Odpowiedzi:
Moim zdaniem jest to dobra praktyka, zakładając, że użytkownicy mają dostęp do odczytu bazy danych błędów. Wiele razy ludzie czekają na naprawienie określonego błędu, aby zdecydować, kiedy dokonać aktualizacji.
Myślę, że to, co się marszczy, to tylko cytowanie identyfikatora błędu i nic więcej. Zawsze powinieneś również podać opis, który jest zrozumiały, bez wchodzenia do narzędzia do śledzenia błędów. Pozwala to również na przełączanie śledzenia błędów w przyszłości bez całkowitego unieważnienia poprzednich informacji o wersji.
źródło
Jest, jak powiedziano w cytowanym komentarzu ... nieprzyjazny.
Nieprzyjazny sobie
Wyobraź sobie następujący scenariusz. Oglądasz dzienniki w kontroli źródła. Zastanawiasz się, co zmieniło się zatwierdzenie. Zamiast objaśniać to zwykłym angielskim, mówi ci:
Prowadzisz system śledzenia błędów, mając nadzieję, że znajdziesz coś pomocnego. Błąd nr 1307 jest zgłaszany jako rozwiązany. W opisie widać:
Dzięki, to bardzo pomocne. Musisz teraz przejść do raportu o błędzie # 1284, aby przeczytać, że jest to duplikat błędu # 1113, który odnosi się do błędów # 1112, # 1065 i # 1067.
Pięć minut później nie masz pojęcia, czego szukasz na początku.
O wiele bardziej przydatnym komunikatem dziennika kontroli wersji byłoby:
W ten sam sposób, w systemie śledzenia błędów, raport nr 1307 może być bardziej zrozumiały , przypominając o czym był raport o błędzie # 1284 i jak nowy różni się od starego.
Nieprzyjazny dla klientów
To nie jedyny problem życzliwości.
Po drugie, odwołując się do zbyt dużej liczby bez dodatkowych informacji, sprawiasz, że notatki o łatce / dzienniki kontroli wersji / raporty systemu śledzenia błędów są bezużyteczne dla osób niezbyt dobrze zaznajomionych z tymi systemami . Kiedy codziennie zajmujesz się systemem śledzenia błędów, wiesz, jak szybko poruszać się po raportach, przeglądać wiele raportów obok siebie itp. Gdy jesteś klientem bez zaplecza technicznego, łatwo możesz się zgubić.
Ponownie, bardziej szczegółowe wiadomości są bardzo pomocne niż tylko odniesienie. Pamiętaj, że nadal chcesz zachować referencje: nic nie jest bardziej złe niż błąd, który jest taki sam jak błąd napotkany dwa tygodnie temu, ale nie pamiętaj jego identyfikatora.
Należy zauważyć, że ten sam problem występuje w wielu jurysdykcjach. Na przykład we Francji ustawodawstwo odwołuje się do wielu źródeł, które mogą się w międzyczasie zmienić. Oznacza to, że aby go w pełni zrozumieć, trzeba czasem spędzać godziny w bibliotece, szukając dziesiątek tekstów odsyłających, z których każdy ma własne odniesienia do innych.
źródło
Nie ma nic złego w cytowaniu numerów problemów w notatkach o poprawkach, pod warunkiem, że użytkownicy mogą przeczytać cytowany problem. Jeśli baza danych błędów pozwala komukolwiek czytać, cytowanie numeru błędu może być bardzo przydatne. (Jeszcze lepiej, jeśli notatki łatek są w formacie, który pozwala na linki, spraw, aby te identyfikatory problemów były linkami do danego problemu.) Nie oznacza to, że powinieneś ujawnić wszystkie problemy ogółowi; nadal przydatne mogą być takie, które są owiane (np. tam, gdzie mają aktywne hasła!)
Powoływanie się na numer problemu, w którym osoba czytająca nie może przejść i sprawdzić szczegółów i historii błędu, jest dość nieprzyjazne. Nie że cytowanie takich problemów bez identyfikatora problemu jest o wiele bardziej przyjazne.
źródło
Oczywiście zależy od tego, kim są ludzie, którzy będą czytać informacje o poprawce, oraz od docelowych użytkowników oprogramowania.
Ale w większości przypadków zdecydowana większość użytkowników po prostu nie dba o identyfikator błędu. Nie obchodzi ich, dlaczego została zepsuta, jaka jest poprawka ani nic innego - chcą tylko wiedzieć, co się zmieniło za pomocą bardzo zwięzłego opisu tekstowego, bez konieczności przechodzenia do kolejnej strony z każdą zmianą.
Cytowanie identyfikatorów błędów powoduje, że przestaję myśleć i ja, jako użytkownik, nie chcę myśleć. To rodzaj problemu z użytecznością.
Spójrz na przykład na dzienniku zmian Visual Assist X . Wszystkie powiązane identyfikatory błędów to po prostu hałas, który odciąga mnie od zrozumienia, co się zmieniło. Jest to dodatek do programu Visual Studio, przeznaczony dla programistów. A ja jestem programistą. Jeśli mi to przeszkadza, wyobraź sobie przeciętnego użytkownika, który nawet nie wie, co to jest narzędzie do śledzenia błędów.
PS: Byłem autorem komentarza, który wywołał pytanie
źródło
Identyfikator błędu jest obowiązkowy dla punktu odniesienia . Powody:
jest wygodniejszy niż:
źródło
Powiedziałbym, że to zależy od twojego systemu: mam szczęście, że ten, którego używam, automatycznie wykrywa takie odniesienia w komunikatach zatwierdzania i dodaje link do biletu zapisanego w narzędziu do śledzenia błędów, więc nie jest to problem.
Ale gdybym był w systemie, w którym nie jest dostępny, nadal wspomniałbym o identyfikatorze biletu (w ten sposób można szybko przeszukiwać dzienniki według identyfikatora biletu ) wraz z krótkim opisem tego, co jest błędem.
źródło