Kako napraviti stranicu sa izmjenama: unosi, oznake, RSS i „Šta je novo“

Stranica sa izmjenama je datirana lista onoga što se promijenilo u vašem proizvodu, najnovije prve, napisana za ljude koji ga koriste. Za njenu izradu su vam potrebni unosi sa datumom, jasnim naslovom, kratkim objašnjenjem i oznakom (Novo, Poboljšano, Ispravljeno), stranica koja ih navodi, zaseban URL za svaki unos i, po mogućnosti, RSS feed i način da korisnicima kažete da je nešto novo. To je jedna od najjednostavnijih stvari koje možete napraviti, a glavna odluka je gdje unosi žive: kao fajlovi na sajtu ili u bazi sa administratorskom stranicom.

Zašto vrijedi imati listu izmjena

Lista izmjena pokazuje kupcima i potencijalnim kupcima da se proizvod održava. Daje podršci i prodaji link koji mogu poslati kada neko pita „da li ovo već radi X?“. Takođe je mjesto za zatvaranje petlje povratnih informacija: kada se zatraženi feature objavi, unos u listi izmjena je ono na šta upućujete ljude. Ako vodite portal za povratne informacije kupaca, povežite isporučene zahtjeve direktno s njihovim unosima.

Lista izmjena nije vaša interna istorija commitova. „Refaktorisan servis za naplatu“ ništa ne znači korisniku. „Računi sada prikazuju PDV broj vaše kompanije“ znači.

Šta stranica treba

Sadržaj za svaki unos

Stranice

• Indeks izmjena: najnovije prve, sa filterima po oznakama i jednostavnim stranicama ili dugmetom „učitaj još“.
• Stranica unosa: jedan unos po URL-u, da može biti linkovan i podijeljen.
• RSS ili Atom feed: omogućava ljudima i alatima da prate izmjene bez e-pošte.
• Administratorska stranica (samo u verziji sa bazom): pisanje, pregled, zakazivanje i objavljivanje unosa.

Dodaci unutar aplikacije

• Značka „Šta je novo“: tačka na stavci menija kada postoje unosi koje korisnik nije vidio. Čuvajte datum posljednjeg unosa koji je otvorio, po korisniku ili u pregledaču.
• E-mail sažetak: pregled poslat korisnicima koji se pretplate. Ovo zahtijeva provajdera za slanje; pogledajte kako slati e-poštu iz aplikacije.

Glavna odluka: fajlovi ili baza

Unosi kao fajlovi na sajtu

Svaki unos je Markdown fajl u projektu. Objavljivanje unosa znači dodavanje fajla i ponovni deploy. Ovo je najjednostavniji i najrobusniji pristup: nema baze, nema administratorske prijave, nema čega da se štiti, a stranice mogu biti unaprijed generisane pa se brzo učitavaju i lako ih pretraživači čitaju.

Odgovara timovima čiji ljudi koji pišu unose mogu da zatraže od AI alata za izradu ili da uređuju fajl.

Unosi u bazi sa administratorskom stranicom

Unosi žive u tabeli, a privatna administratorska stranica omogućava bilo kome u timu da piše, pregleda, zakazuje i objavljuje. Odgovara timovima gdje marketing ili podrška pišu novosti, ili gdje želite zakazano objavljivanje ili unose po publici (na primjer, da se funkcije za poslovne korisnike prikazuju samo njima).

Cijena je više posla za izgradnju i održavanje: administratorska prijava, otpremanje slika i osiguranje da javne stranice ostaju čitljive pretraživačima, što stranica koja učitava unose samo u pregledaču možda neće biti.

Pisanje unosa koje ljudi čitaju

• Počnite s koristi. „Izvoz izvještaja u Excel“ je bolje od „Novi modul za izvoz“.
• Recite ko to dobija. Svi planovi, samo Pro, uvodi se ove sedmice.
• Pokažite. Jedan snimak ekrana ili kratak klip.
• Grupišite sitne ispravke. Sedmični unos „Ispravke i poboljšanja“ s tačkama spriječava da stranica bude preplavljena.
• Budite iskreni o uklanjanju. Ako nešto nestaje, recite kada i šta da se koristi umjesto toga.

Prvi upit koji radi

Dodaj javnu listu izmjena na naš sajt na /changelog. Svaki unos je Markdown fajl sa naslovom, datumom, oznakom (Novo, Poboljšano ili Ispravljeno), opcionom naslovnom slikom i tekstom. Indeks stranica prikazuje unose, najnovije prve, sa datumom, oznakom i prvim pasusom, ima dugmad za filtriranje po oznakama i prikazuje 10 unosa po stranici. Svaki unos ima vlastitu stranicu na /changelog/<slug> sa ispravnim naslovom i opisom za pretraživače. Dodaj RSS feed na /changelog/rss.xml. Napravi tri primjer unosa. Uskladi dizajn s postojećim sajtom, neka bude čitljivo na telefonima i unaprijed generiši stranice da se brzo učitavaju.

Za verziju sa bazom, prvu rečenicu zamijenite s „Čuvaj unose u bazi sa statusom nacrta/objavljeno i datumom objave, i dodaj administratorsku stranicu zaštićenu prijavom za pisanje, pregled i objavljivanje.“

Koraci izgradnje

1. Odlučite fajlovi ili baza prema tabeli iznad.
2. Izgradite stranice indeksa i unosa sa nekoliko primjer unosa.
3. Dodajte oznake i filtere.
4. Dodajte RSS feed i povežite ga sa stranicom.
5. Dodajte naslove stranica, opise i unos u sitemap za svaki unos. Naš vodič SEO za sajtove napravljene uz AI pokriva osnove.
6. Administratorska stranica i prijava, ako ste izabrali verziju sa bazom.
7. Značka „Šta je novo“ u vašoj aplikaciji.
8. Napišite prave unose za posljednjih nekoliko mjeseci, da stranica ne bude prazna pri lansiranju.

Česte greške

• Kopiranje poruka commitova. Pišite za korisnike, a ne za programere.
• Jedna velika stranica bez URL-ova po unosu. Niko ne može linkovati na određenu promjenu, a pretraživači vide jednu stranicu umjesto mnogo.
• Ažuriranja stanu nakon mjesec dana. Lista izmjena zadnji put ažurirana prije godinu sugeriše napušten proizvod. Postavite ritam koji možete održati.
• Učitavanje unosa samo u pregledaču. Pretraživači i pregledi linkova mogu vidjeti praznu stranicu. Unaprijed generišite ili renderujte na serveru.
• Miješanje incidenata. Prekidi rada pripadaju na statusnu stranicu, a ne na listu izmjena.

Kada je hostovani alat za izmjene bolji izbor

Postoje hostovani alati za izmjene i ažuriranja proizvoda, a neki dolaze uz oglasne table za povratne informacije ili widgete u aplikaciji. Vrijede ako želite skočni prozor u aplikaciji, ciljanje publike i analitiku bez njihove izrade, ili ako vaš tim već plaća alat koji to uključuje. Vaš softver za blog ili centar za pomoć takođe može imati odgovarajući format.

Pravljenje sopstvene liste ima smisla kada želite listu izmjena na vlastitom domenu, u vlastitom dizajnu i u potpunosti indeksiranu, a za jednostavnu listu datiranih objava to nije mnogo posla.

Izgradnja uz Mythex

U Mythexu možete zatražiti od agenta da doda listu izmjena u postojeći projekat ili da je napravi kao zaseban mali sajt, i vidite je u živom pregledu dok se gradi. Verzija sa fajlovima ne treba bazu. Ako izaberete verziju s administracijom, agent dodaje namjensku Postgres bazu kada unosi treba da se čuvaju (ili unesite /database), a snimci ekrana idu u pohranu fajlova projekta. Prijava za administraciju je nešto što dodajete sopstvenim pristupom autentifikaciji (recept za dodavanje prijave).

Nove Mythex aplikacije su često jednostranične aplikacije renderovane na klijentu, za koje SEO recept kaže da su slabije za pretragu, pa zatražite statičke ili unaprijed generisane stranice izmjena ako želite da ih pretraga nađe. Isti recept pokriva naslove, opise i sitemape. Za početnu tačku s ugrađenom listom izmjena, pogledajte šablon product knowledge hub.

Pitanja