Kako izraditi stranicu s promjenama: unosi, oznake, RSS i „Što je novo“

Stranica s promjenama je datirani popis onoga što se promijenilo u tvom proizvodu, najnovije prve, napisan za ljude koji ga koriste. Za izradu trebaš unose s datumom, jasnim naslovom, kratkim objašnjenjem i oznakom (Novo, Poboljšano, Ispravljeno), stranicu koja ih navodi, zaseban URL za svaki unos i idealno RSS feed te način da korisnicima kažeš da je nešto novo. To je jedna od najjednostavnijih stvari koje možeš izraditi, a glavna odluka je gdje unosi žive: kao datoteke na tvojoj stranici ili u bazi podataka s administratorskom stranicom.

Zašto vrijedi imati stranicu s promjenama

Stranica s promjenama pokazuje kupcima i potencijalnim kupcima da se proizvod održava. Daje prodaji i podršci poveznicu koju mogu poslati kad netko pita „podržava li to već X?“. Također je mjesto za zatvaranje petlje povratnih informacija: kad se zatraženi značajka objavi, unos u stranici s promjenama je ono na što upućuješ ljude. Ako vodiš portal za povratne informacije kupaca, poveži isporučene zahtjeve izravno na njihove unose.

Stranica s promjenama nije tvoja interna povijest commitova. „Refaktoriran servis naplate“ ne znači ništa korisniku. „Računi sada prikazuju OIB tvoje tvrtke“ znači.

Što stranica treba

Sadržaj za svaki unos

Stranice

• Indeks stranice s promjenama: najnovije prve, s filtrima oznaka i jednostavnim stranicenjem ili „učitaj više“.
• Stranica unosa: jedan unos po URL-u, da se može povezati i dijeliti.
• RSS ili Atom feed: omogućuje ljudima i alatima da prate ažuriranja bez e-pošte.
• Administratorska stranica (samo u verziji s bazom podataka): pisanje, pregled, zakazivanje i objava unosa.

Dodaci u aplikaciji

• Značka „Što je novo“: točkica na stavci izbornika kad postoje unosi koje korisnik nije vidio. Spremi datum posljednjeg unosa koji je otvorio, po korisniku ili u pregledniku.
• E-poštni sažetak: sažetak poslan korisnicima koji su se odlučili za to. Ovo treba pružatelja za slanje; pogledaj kako slati e-poštu iz svoje aplikacije.

Velika odluka: datoteke ili baza podataka

Unosi kao datoteke na stranici

Svaki unos je Markdown datoteka u projektu. Objava unosa znači dodavanje datoteke i ponovnu isporuku. Ovo je najjednostavniji i najrobusniji pristup: nema baze podataka, nema administratorske prijave, nema čega osiguravati, a stranice se mogu prerenderirati pa se brzo učitavaju i lako ih tražilice čitaju.

Prikladno je timovima u kojima su ljudi koji pišu unose spremni zatražiti od AI alata za izradu ili uređivati datoteku.

Unosi u bazi podataka s administratorskom stranicom

Unosi žive u tablici, a privatna administratorska stranica omogućuje bilo kome iz tima da piše, pregleda, zakazuje i objavljuje. Ovo odgovara timovima u kojima marketing ili podrška pišu ažuriranja, ili u kojima želiš zakazanu objavu ili unose po publici (primjerice, prikazati značajke za poduzeća samo kupcima iz poduzeća).

Trošak je više posla za izradu i održavanje: administratorska prijava, učitavanje slika i osiguravanje da javne stranice ostanu čitljive tražilicama, što stranica koja učitava unose samo u pregledniku možda neće biti.

Pisanje unosa koje ljudi čitaju

• Počni s koristi. „Izvoz izvještaja u Excel“ bolje je od „novi modul za izvoz“.
• Reci tko to dobiva. Svi paketi, samo Pro, uvodi se ovaj tjedan.
• Pokaži. Jedna snimka zaslona ili kratki isječak.
• Grupiraj sitne ispravke. Tjedni unos „Ispravci i poboljšanja“ s stavkama sprječava da stranica bude preplavljena.
• Budi iskren o uklanjanjima. Ako nešto nestaje, reci kada i što koristiti umjesto toga.

Primjer prvog upita

Dodaj javnu stranicu s promjenama na našu web stranicu na /changelog. Svaki unos je Markdown datoteka s naslovom, datumom, oznakom (Novo, Poboljšano ili Ispravljeno), opcionalnom naslovnom slikom i tekstom. Indeks prikazuje unose najnovije prve s datumom, oznakom i prvim odlomkom, ima gumbe za filtriranje oznaka i prikazuje 10 unosa po stranici. Svaki unos ima vlastitu stranicu na /changelog/<slug> s pravilnim naslovom stranice i opisom za tražilice. Dodaj RSS feed na /changelog/rss.xml. Napravi tri uzorna unosa. Uskladi se s postojećim dizajnom stranice, neka bude čitljivo na telefonima i prerenderiraj stranice da se brzo učitavaju.

Za verziju s bazom podataka zamijeni prvu rečenicu sa „Spremi unose u bazu podataka sa statusom nacrt/objavljeno i datumom objave te dodaj administratorsku stranicu zaštićenu lozinkom za pisanje, pregled i objavu.“

Koraci izrade

1. Odluči datoteke ili bazu podataka prema tablici iznad.
2. Izradi indeks i stranice unosa s nekoliko uzorčnih unosa.
3. Dodaj oznake i filtre.
4. Dodaj RSS feed i poveži ga sa stranice.
5. Dodaj naslove stranica, opise i unos u sitemapu za svaki unos. Naš vodič o SEO-u za web stranice izrađene uz AI pokriva osnove.
6. Administratorska stranica i prijava, ako si odabrao put s bazom podataka.
7. Značka „Što je novo“ u tvojoj aplikaciji.
8. Napiši prave unose za posljednjih nekoliko mjeseci da stranica ne bude prazna pri pokretanju.

Česte greške

• Kopiranje poruka commitova. Piši za korisnike, ne za developere.
• Jedna ogromna stranica bez URL-ova po unosu. Nitko ne može poveznicu na određenu promjenu, a tražilice vide jednu stranicu umjesto mnogo.
• Ažuriranja prestanu nakon mjesec dana. Stranica s promjenama zadnji put ažurirana prije godinu dana sugerira napušten proizvod. Postavi ritam koji možeš održati.
• Učitavanje unosa samo u pregledniku. Tražilice i pregledi poveznica mogu vidjeti praznu stranicu. Prerenderiraj ili renderiraj na poslužitelju.
• Miješanje incidenata. Prekidi pripadaju statusnoj stranici, a ne stranici s promjenama.

Kada je hostirani alat za promjene bolji izbor

Postoje hostirani alati za stranice s promjenama i ažuriranja proizvoda, a neki dolaze s pločama za povratne informacije ili widgetima u aplikaciji. Vrijede ako želiš skočni prozor u aplikaciji, ciljanje publike i analitiku bez njihove izrade, ili ako tvoj tim već plaća alat koji to uključuje. Tvoj softver za blog ili centar za pomoć također može imati prikladan format.

Izrada vlastite ima smisla kad želiš stranicu s promjenama na vlastitoj domeni, u vlastitom dizajnu i potpuno indeksiranu, što za jednostavan popis datiranih objava nije mnogo posla.

Izrada s Mythexom

U Mythexu možeš zamoliti agenta da doda stranicu s promjenama postojećem projektu ili je izradi kao vlastitu malu stranicu, i vidjeti je u živom pregledu dok se izrađuje. Verzija s datotekama ne treba bazu podataka. Ako odabereš administratorsku verziju, agent dodaje namjensku Postgres bazu podataka kad unosi trebaju biti spremljeni (ili upiši /database), a snimke zaslona idu u pohranu datoteka projekta. Prijava za administraciju je nešto što dodaješ sam svojim pristupom za autentikaciju (recept za dodavanje prijave).

Nove Mythex aplikacije su često jednostranične aplikacije renderirane na klijentu, za koje SEO recept kaže da su slabije za pretraživanje, pa zatraži statične ili prerenderirane stranice s promjenama ako želiš da se unosi pronađu u pretrazi. Isti recept pokriva naslove, opise i sitemape. Za polaznu točku s ugrađenom stranicom s promjenama pogledaj predložak centar znanja o proizvodu.

Pitanja