Wybór odpowiednich wskaźników dla projektu

Ten przewodnik ma na celu pomóc organizacjom w zrozumieniu, jakie problemy można rozwiązać dzięki lepszej dokumentacji, a także w jaki sposób wybrać odpowiednie wskaźniki do projektów związanych z dokumentacją.

Obecny etap:
ogłoszenie wyników. Sprawdź oś czasu.

Opisz problem

Zanim zaczniesz wybierać dane, upewnij się, że dobrze rozumiesz problem, który próbujesz rozwiązać. Podaj jak najwięcej szczegółów.

  • „Przesyłanie próśb o udostępnienie dokumentacji wprowadzającej trwa zbyt długo. Współtwórcy poddają się i odchodzą”.
  • „Widzimy zbyt wiele zgłoszeń, które pomagają w zrozumieniu kodów błędów”.
  • „Nasz potok CI/CD ma problemy z działaniem. Zbyt wiele testów kończy się niepowodzeniem z powodów niezrozumiałych”.
  • „Na naszych cotygodniowych spotkaniach ludzie wydają się zdenerwowani”.

Opracuj hipotezę

Szukaj przyczyn i skutków. Co może być przyczyną opisanego przez Ciebie problemu? Pamiętaj, że problemy mogą mieć wiele przyczyn lub się pokrywać.

  • „Scalanie żądań pull dotyczących dokumentacji wprowadzającej trwa bardzo długo, ponieważ nie mamy jasnych wytycznych dotyczących stylu. Weryfikatorzy odkładają sprawdzanie PR, ponieważ nie wiedzą, co robić, lub na bieżąco rozmawiają z osobami zajmującymi się formatowaniem”.
  • „Użytkownicy muszą zgłaszać problemy, ponieważ nie mogą znaleźć w dokumentacji informacji o kodach błędów”.
  • „Nasze testy CI/CD kończą się niepowodzeniem, ponieważ nasze plany i czas oczekiwania są ograniczone”.
  • „Na naszych cotygodniowych spotkaniach ludzie mają zmęczenie, ponieważ spotkania mają godzinę 5:30 w ich strefie czasowej”.

Zaproponuj rozwiązanie

Czy ten problem można rozwiązać, używając nowej lub lepszej dokumentacji?

  • „Gdybyśmy mieli wskazówkę dotyczącą stylu, weryfikatorzy mogliby ją sprawdzić przed przesłaniem swoich informacji PR. Weryfikatorzy wiedzą, co sprawdzić. Weryfikatorzy i współtwórcy nie będą musieli się kłócić o format, ton i styl”.
  • „Gdybyśmy mieli dokumentację na temat kodu błędu, użytkownicy mogliby znaleźć w niej odpowiedzi, zamiast otwierać problemy”.
  • „Wygląda na to, że lepsza dokumentacja nie rozwiąże naszego problemu CI/CD”.
  • „Każde spotkanie zaczynamy od żartu „puk, puk”. Stworzenie kolekcji dowcipów o pukaniu, mogłoby pomóc nam rozpoczynać spotkania z uśmiechem”.

Skoncentruj się

Czy potrafisz zmierzyć problem?

  • „Co tak naprawdę oznacza «scalanie elementów PR trwa zbyt długo? Dwa miesiące? Dwa tygodnie? Jak długo współtwórcy będą czekać na sprawdzenie, zanim zrezygnują?”
  • „Ile problemów z kodem błędu oznacza „zbyt wiele problemów”?
  • „Hmmm... Jak bardzo naburmuszone jest?”.

Sprawdź mierzalność

Jak można sprawdzić proponowane dane? Czy można je łatwo i dokładnie mierzyć? Czy pomiar zależy od tego, kto go przeprowadza?

  • „Możemy z łatwością sprawdzić, jak długo prośba o weryfikację jest otwarta, a także jak długo od niej została przesłana. Nie jesteśmy w stanie dokładnie określić, kiedy dany użytkownik rezygnuje”.
  • „Możemy policzyć, ile problemów zostało oznaczonych tagiem „error-code” (kod błędu) lub wyszukać w problemach tekst kodu błędu”.
  • „Nie jesteśmy w stanie dokładnie zmierzyć narzekania ludzi w sposób taktyczny lub dokładny”.

Dodaj dodatkowe dane

Czy są inne wskaźniki, które pomogłyby ustalić, czy Twoja dokumentacja rozwiązuje problem? Czy Twoje docelowe dane są takie same w każdym przypadku?

  • „Sprawdzanie dłuższego PR wymaga więcej czasu. Dla różnych rozmiarów powinniśmy wyznaczyć różne progi. Chcemy mierzyć czas scalenia w przypadku małych, średnich, dużych i ogromnych podmiotów”.
  • „Możemy sprawdzić, ile wizyt otrzymuje nasz kod błędu i czy liczba ta odpowiada mniejszej liczbie otwieranych problemów”.

Wybierz przedział czasu

  • „Uważamy, że 2 tygodnie to wystarczający czas na scalenie małych i średnich kontaktów PR. Wszystkie PR powinny zostać połączone w ciągu miesiąca. Będziemy więc dokonywać pomiarów co 2 tygodnie”.
  • „Nie ma sensu aktualizować codziennej liczby problemów związanych z kodem błędu, ponieważ zwykle zamykamy problem w ciągu tygodnia. Będziemy to robić co tydzień”.

Zapisz cele

Jak bardzo należy zmienić wybrany wskaźnik, aby można było stwierdzić, że projekt zakończył się sukcesem? Rozważ wyznaczenie celów ilościowych dla wybranych danych.

  • „Osiągniemy cel, by zamknąć wszystkie nowe kampanie PR w niecałe miesiąc, to bylibyśmy tylko sukcesem. Gdyby skrócił się średni czas na zamykanie dużych poziomów PR o 2 tygodnie, to byłby wielki sukces”.
  • „W idealnej sytuacji nie zauważymy żadnych nowych problemów związanych z błędami. Uznaliśmy jednak, że nasz projekt się uda, gdy odnotujemy 50% spadek liczby problemów z błędami”.