Spis dokumentacji13 / 20

Zachowaj swoje decyzje13 / 20

Spójrz wstecz na każdą wersję

Na tej stronie

Każda zmiana w dokumentach założeń jest zachowywana. Wybierz wersję, by zobaczyć, które dokumenty zmieniła i co zmieniło się w każdym, czy edycję wprowadziłeś Ty, czy Agent zaproponował ją, a Ty zaakceptowałeś, i jak tekst był wtedy wyjaśniony. To, jak doszedłeś do decyzji, nadal tu jest.

Otwórz historię wersji

Są trzy wejścia:

  • Najedź na nagłówek „intents” w pasku bocznym i kliknij przycisk historii.
  • Wybierz View → Version History albo naciśnij ⌘Y (Ctrl+Y w Windows i Linuksie).
  • W notatce z napisem „This explains the previous text” kliknij „View in version history”.

Pierwsze dwa tylko przełączają pasek boczny i wybierają najnowszą wersję; główny obszar zostaje taki, jaki był. Trzecie wybiera najnowszą wersję, która zmieniła ten dokument, i podmienia bieżący dokument na miejscu na jego tamtą wersję.

Gdy jesteś w historii, karty, układy obok siebie, panel kodu i czaty w głównym obszarze działają jak zwykle. Kliknij „Exit version history” u góry paska bocznego, by wrócić do zwykłego paska bocznego; karta historii zamyka się razem z nim.

Skąd biorą się wersje

Każda zmiana Twoich dokumentów założeń to wersja. Według źródła są to:

ŹródłoTytuł na liście
Zaakceptowałeś propozycjęTytuł propozycji, na przykład „Wyślij e-mail do właściciela zespołu, gdy zaczyna się okres karencji”
Zaakceptowałeś plan uporządkowaniaOrganized
Zapisałeś w Noea albo zmieniłeś pliki poza NoeaManual edits. Kolejne ręczne edycje scalają się w jedną wersję do zakończenia następnego Explain
Każdy zmieniony dokument wrócił do stanu już zapisanegoBack to „tytuł tej wersji”
Dokumenty takie, jakie były na początku zapisywaniaRecording started

Przeczytaj listę wersji

W historii dolna część paska bocznego staje się listą wersji, pogrupowaną według dni, od najnowszej. Każda wersja zajmuje dwie linie: tytuł, a potem jej czas, ikonę statusu, ikonę źródła i liczbę zmienionych dokumentów, na przykład „2 documents”.

  • Czas: wersja z ręcznymi edycjami pokazuje przedział od pierwszej do ostatniej edycji, oznaczony „In progress”, dopóki się nie zamknie.
  • Status: wyjaśniona, badana albo jeszcze niewyjaśniona, czyli czy tekst tej wersji ma swoje wyjaśnienia; najedź, by zobaczyć, które.
  • Źródło: odróżnia Twoje edycje od edycji Agenta; powrót do wcześniejszej wersji ma własną ikonę.
Historia wersji: wersje pogrupowane według dni po lewej, z wybraną wersją „Uporządkowano: scalono zasadę przechowywania danych” i dokumentami, które zmieniła, oznaczonymi w drzewie; po prawej dokument Odnowienie zaznacza zdania, które ta wersja zmieniła.

Górna część paska bocznego to nadal Twoje drzewo dokumentów, zagnieżdżone i rozwinięte jak wcześniej. Dokumenty zmienione przez wybraną wersję są oznaczone:

ZmianaZnacznik
UtworzonyZielona kropka obok nazwy
ZmodyfikowanyŻółta kropka obok nazwy
UsuniętyWymieniony tam, gdzie był ostatnio, przekreślony na czerwono i przyciemniony
PrzemianowanyNowa nazwa, ze starą blado obok

Otwórz dokument taki, jaki był

Wybierz wersję i kliknij dokument w drzewie; główny obszar otwiera go takim, jaki był w tej wersji. Dokument z historii jest tylko do odczytu, z kłódką obok tytułu, która po najechaniu mówi, jaka to wersja; układ, konspekt, wyszukiwanie i notatki działają jak zwykle, a tekst możesz zaznaczać i kopiować.

Dokument zaznacza, co ta wersja zmieniła względem poprzedniej, w stylu trybu przeglądu: dodane, przepisane i usunięte, z usuniętymi akapitami zostawionymi na miejscu. Możesz przechodzić po nich na dole.

Jeśli ta wersja nie zmieniła dokumentu, widzisz jego treść z ostatniej zmiany przed nią, z czasem, z którego pochodzi. Jeśli dokument w tej wersji jeszcze nie istniał albo ta wersja go usunęła, też jest to powiedziane.

Gdy wybierzesz inną wersję, otwarty dokument z historii podąża za nią, pokazując ten sam dokument taki, jaki był w tamtej wersji. Okno ma naraz jedną kartę historii.

Zobacz ówczesne wyjaśnienia

Każdy akapit w dokumencie z historii pokazuje wyjaśnienie tekstu tej wersji. Jeśli akapit został później przepisany lub usunięty, jego notatka otwiera się z „This explains this version's text”: wyjaśnia tekst taki, jaki był wtedy, a nie dokument taki, jaki jest teraz. Akapity, których ta wersja nie wyjaśniła, są oznaczone jako jeszcze niewyjaśnione, a te w trakcie badania jako badane.

Dzięki temu możesz odpowiedzieć na pytanie „dlaczego wtedy zaimplementowano to tak?”. Na przykład gdy trzy tygodnie temu zaakceptowano propozycję okresu karencji, jej wyjaśnienie wymieniało wybór liczenia 7 dni jako 168 godzin; dopiero później zmieniono to na dni kalendarzowe w strefie czasowej zespołu.

Jeśli chcesz odzyskać wcześniejszą wersję

Historia wersji służy do patrzenia wstecz; nie ma „restore this version”. Żeby coś przywrócić, skopiuj tekst z dokumentu historii, wklej go do bieżącego dokumentu i zapisz; albo poproś Agenta na czacie o przygotowanie propozycji, która zmienia akapit z powrotem na wcześniejsze brzmienie, i zaakceptuj ją po przejrzeniu.

Jeśli trzymasz folder zamiaru w Git, możesz też przywrócić pliki przez Git. Gdy każdy dokument wraca do zapisanego stanu, lista wersji pokazuje wpis zatytułowany „Back to …”.