Jak zbudować stronę z listą zmian: wpisy, tagi, RSS i „Co nowego”

Strona z listą zmian to chronologiczny spis tego, co zmieniło się w Twoim produkcie, od najnowszego, pisany z myślą o ludziach, którzy go używają. Aby ją zbudować, potrzebujesz wpisów z datą, jasnym tytułem, krótkim wyjaśnieniem i tagiem (Nowość, Ulepszenie, Naprawiono), strony, która je wyświetla, osobnego adresu URL dla każdego wpisu i najlepiej kanału RSS oraz sposobu, by poinformować użytkowników, że coś jest nowe. To jeden z najprostszych elementów do zbudowania, a główną decyzją jest to, gdzie mieszkają wpisy: jako pliki w serwisie czy w bazie danych z panelem administracyjnym.

Po co prowadzić listę zmian

Lista zmian pokazuje klientom i potencjalnym klientom, że produkt jest rozwijany. Daje też obsłudze i sprzedaży link do wysłania, gdy ktoś pyta „czy to już potrafi X?”. To również sposób na domknięcie pętli z opiniami: gdy zgłoszona funkcja trafia do wydania, wpis w liście zmian jest tym, do czego kierujesz ludzi. Jeśli prowadzisz portal z opiniami klientów, linkuj zrealizowane zgłoszenia bezpośrednio do ich wpisów.

Lista zmian to nie Twoja wewnętrzna historia commitów. „Refaktoryzacja usługi rozliczeń” nic nie znaczy dla użytkownika. „Faktury pokazują teraz numer NIP Twojej firmy” — znaczy.

Czego potrzebuje strona

Treść każdego wpisu

Strony

• Strona główna listy zmian: od najnowszego, z filtrami tagów i prostą paginacją albo przyciskiem „załaduj więcej”.
• Strona wpisu: jeden wpis pod jednym adresem URL, dzięki czemu można go linkować i udostępniać.
• Kanał RSS lub Atom: pozwala ludziom i narzędziom śledzić aktualizacje bez e-maila.
• Panel administracyjny (tylko w wersji z bazą danych): pisanie, podgląd, planowanie i publikowanie wpisów.

Dodatki w aplikacji

• Odznaka „Co nowego”: kropka przy pozycji menu, gdy są wpisy, których użytkownik jeszcze nie widział. Zapisuj datę ostatnio otwartego wpisu — dla użytkownika albo w przeglądarce.
• Podsumowanie e-mailem: streszczenie wysyłane osobom, które się na nie zgodziły. Wymaga dostawcy wysyłki; zobacz jak wysyłać e-maile z aplikacji.

Główna decyzja: pliki czy baza danych

Wpisy jako pliki w serwisie

Każdy wpis to plik Markdown w projekcie. Opublikowanie wpisu oznacza dodanie pliku i ponowne wdrożenie. To najprostsze i najbardziej niezawodne podejście: bez bazy danych, bez logowania do panelu, nic do zabezpieczania, a strony mogą być wstępnie renderowane, więc ładują się szybko i są łatwe do odczytania dla wyszukiwarek.

Pasuje do zespołów, w których osoby piszące wpisy czują się dobrze, prosząc kreator AI o zmiany albo edytując plik.

Wpisy w bazie danych z panelem administracyjnym

Wpisy są zapisane w tabeli, a prywatna strona administracyjna pozwala każdemu z zespołu pisać, podglądać, planować i publikować. Pasuje do zespołów, w których marketing lub obsługa piszą aktualizacje, albo gdy potrzebujesz planowanej publikacji lub wpisów dla konkretnych grup (na przykład pokazywać funkcje dla firmowych klientów tylko im).

Koszt to więcej do zbudowania i utrzymania: logowanie do panelu, przesyłanie obrazów oraz zadbanie o to, by publiczne strony były nadal czytelne dla wyszukiwarek, czego strona ładująca wpisy tylko w przeglądarce może nie zapewnić.

Pisanie wpisów, które ludzie czytają

• Zacznij od korzyści. „Eksport raportów do Excela” jest lepsze niż „Nowy moduł eksportu”.
• Napisz, kto to dostaje. Wszystkie plany, tylko Pro, wdrażane w tym tygodniu.
• Pokaż to. Jeden zrzut ekranu albo krótkie wideo.
• Grupuj drobne poprawki. Cotygodniowy wpis „Poprawki i ulepszenia” z punktami nie zaleje strony.
• Bądź szczery co do usunięć. Jeśli coś znika, napisz kiedy i czym to zastąpić.

Pierwszy prompt, który działa

Dodaj do naszej strony publiczną listę zmian pod adresem /changelog. Każdy wpis to plik Markdown z tytułem, datą, tagiem (Nowość, Ulepszenie lub Naprawiono), opcjonalnym obrazem okładki i treścią. Strona główna wyświetla wpisy od najnowszego, z datą, tagiem i pierwszym akapitem, ma przyciski filtrów tagów i pokazuje 10 wpisów na stronę. Każdy wpis ma własną stronę pod adresem /changelog/<slug> z właściwym tytułem i opisem dla wyszukiwarek. Dodaj kanał RSS pod adresem /changelog/rss.xml. Utwórz trzy przykładowe wpisy. Dopasuj do istniejącego wyglądu strony, zadbaj o czytelność na telefonach i wstępnie renderuj strony, aby ładowały się szybko.

W wersji z bazą danych zamień pierwsze zdanie na: „Przechowuj wpisy w bazie danych ze statusem szkic/opublikowany i datą publikacji oraz dodaj chroniony hasłem panel administracyjny do pisania, podglądu i publikowania wpisów.”

Kroki budowy

1. Wybierz pliki albo bazę danych, korzystając z powyższej tabeli.
2. Zbuduj stronę główną i strony wpisów z kilkoma przykładowymi wpisami.
3. Dodaj tagi i filtry.
4. Dodaj kanał RSS i połącz go ze stroną.
5. Dodaj tytuły stron, opisy i wpis w mapie witryny dla każdego wpisu. Nasz przewodnik po SEO dla stron zbudowanych przez AI omawia podstawy.
6. Panel administracyjny i logowanie, jeśli wybrałeś wersję z bazą danych.
7. Odznaka „Co nowego” w Twojej aplikacji.
8. Napisz prawdziwe wpisy z ostatnich kilku miesięcy, aby strona nie wystartowała pusta.

Częste błędy

• Kopiowanie komunikatów commitów. Pisz dla użytkowników, nie dla programistów.
• Jedna ogromna strona bez adresów URL dla poszczególnych wpisów. Nikt nie może zlinkować konkretnej zmiany, a wyszukiwarki widzą jedną stronę zamiast wielu.
• Aktualizacje ustają po miesiącu. Lista zmian, która była aktualizowana rok temu, sugeruje porzucony produkt. Ustal rytm, który utrzymasz.
• Ładowanie wpisów tylko w przeglądarce. Wyszukiwarki i podglądy linków mogą zobaczyć pustą stronę. Wstępnie renderuj lub renderuj po stronie serwera.
• Mieszanie awarii. Przestoje należą na stronę statusu, a nie na listę zmian.

Kiedy lepsze jest gotowe narzędzie do listy zmian

Istnieją hostowane narzędzia do listy zmian i aktualizacji produktu; niektóre są dołączone do tablic z opiniami albo widżetów w aplikacji. Warto po nie sięgnąć, jeśli chcesz wyskakujące okienko w aplikacji, targetowanie odbiorców i analitykę bez budowania ich samodzielnie albo jeśli Twój zespół już płaci za narzędzie, które je zawiera. Oprogramowanie do bloga lub centrum pomocy może też mieć odpowiedni format.

Buduj własną, gdy chcesz listę zmian na własnej domenie, we własnym wyglądzie i w pełni indeksowalną, co dla prostej listy wpisów z datami nie wymaga wiele pracy.

Budowanie z Mythex

W Mythex możesz poprosić agenta o dodanie listy zmian do istniejącego projektu albo zbudowanie jej jako osobnej małej strony, a zobaczysz ją w podglądzie na żywo w trakcie budowy. Wersja oparta na plikach nie wymaga bazy danych. Jeśli wybierzesz wersję z panelem, agent doda dedykowaną bazę Postgres, gdy wpisy trzeba będzie zapisywać (lub wpisz /database), a zrzuty ekranu trafią do magazynu plików projektu. Logowanie do panelu dodajesz własnym podejściem do uwierzytelniania (przepis na dodawanie logowania).

Nowe aplikacje Mythex są często jednostronicowymi aplikacjami renderowanymi po stronie klienta, co — jak wskazuje przepis SEO — jest słabsze dla wyszukiwarek, więc jeśli chcesz, aby wpisy były widoczne w wyszukiwarce, poproś o statyczne lub wstępnie renderowane strony listy zmian. Ten sam przepis obejmuje tytuły, opisy i mapy witryny. Na początek ze wbudowaną listą zmian zobacz szablon centrum wiedzy o produkcie.

Pytania