Návody: Struktura, Kroky a Schéma
Vytvořte návod, který promění cíl čtenáře v uspořádané a testovatelné kroky s předpoklady, signály úspěchu, možnostmi obnovy a řešením problémů.
Návod je uspořádaný postup, který vede čtenáře od známého výchozího stavu k ověřenému výsledku. Odpovídá na otázku „Jak dokončím tento úkol?“, aniž by čtenář musel vymýšlet chybějící krok.
Každý krok potřebuje imperativní název, svůj důvod, akci, pozorovatelný stav úspěchu a možnost obnovy. Pouze instrukce typu „klikněte na“ fungují jen tehdy, když účet, přístup, data a rozhraní čtenáře náhodou odpovídají předpokladům autora.
Zodpovězená otázka čtenáře: „Co potřebuji, co mám udělat v jakém pořadí, jak poznám, že to fungovalo, a jak se zotavím, pokud ne?“
Otázky, na které odpovídá
Návod slouží informačnímu záměru , což znamená, že se čtenář snaží naučit nebo dokončit úkol, nikoli hodnotit seznam produktů. Dotaz často začíná slovy „jak na to“, ale samotné znění nestačí. Zamýšlený výsledek musí být něco, co čtenář může provést a ověřit.
Pište pro otázky, které lidé skutečně vnášejí do postupu:
- „Mám požadovaný tarif, přístup, nástroje a čas?“
- „Které akce musí proběhnout v pořadí a co by se mělo objevit po každé z nich?“
- „Může to přepsat, publikovat, účtovat, smazat nebo odhalit něco?“
- „Jak se zotavím z jiného výsledku a potvrdím, že celý úkol fungoval?“
Přímá odpověď by měla uvést výsledek, výchozí podmínku, očekávaný čas a obtížnost ještě před prvním dlouhým vysvětlením. „Správce účtu může přibližně za 20 minut připojit Search Console a ověřit první úspěšný import“ je užitečné. „Tento průvodce zkoumá osvědčené postupy integrace“ užitečné není.
Kdy tento typ příspěvku použít
Postupy selhávají na hranicích předpokladů. Autor ví, na jakém přístupu, zpoždění nebo nastavení záleží; čtenář ne. Tento formát zviditelňuje skryté závislosti, změny stavu a rozhodnutí o návratu v pořadí.
| Zaměnitelný typ | Zvolte jej, když čtenář začíná s | Tvar odpovědi | Proč to není tento typ |
|---|---|---|---|
| Návod | Cílem: „Potřebuji dokončit X“ | Předpoklady, uspořádané kroky, signály úspěchu, obnova, kontrola dokončení | Je to samotný postup. |
| Jak vybrat X | Rozhodnutím: „Které X se ke mně hodí?“ | Kritéria, alternativy, kompromisy, doporučení | „Vybrat“ popisuje hodnocení, nikoli posloupnost akcí s testovatelným výsledkem. |
| Článek o řešení problémů | Příznakem: „X selhalo“ nebo „Vidím chybu Y“ | Diagnostický strom od příznaku k příčině k opravě | Začíná poté, co již pokus o postup vytvořil problém. |
| Dokumentační článek | Potřebou vyhledat chování, pole, limity nebo syntaxi | Reference uspořádaná pro vyhledávání, nikoli pro jednu čtecí cestu | Podporuje mnoho úkolů a neslibuje jednu narativní cestu k jednomu výsledku. |
Zvolte návod pouze tehdy, když záleží na pořadí. Pokud lze nezávislé kontroly provést v libovolném pořadí, publikujte kontrolní seznam. Pokud je téma natolik široké, že obsahuje několik odlišných cílů, použijte ultimátního průvodce jako mapu a vytvořte samostatné návody pro jednotlivé postupy. Pokud se čtenář primárně ptá, co daný koncept znamená, použijte co-je-X stránku .
Nejvhodnější pro tyto typy podnikání
Pořadí odráží, jak často model závisí na tom, že čtenář dokončí opakovatelný proces, nikoli celkovou hodnotu obsahu pro firmu.
- SaaS . Nastavení, konfigurace, migrace a opakující se pracovní postupy určují, zda uživatelé dosáhnou hodnoty. Rozlišujte limity tarifů, role, stavy rozhraní a destruktivní změny.
- Ecommerce . Kupující potřebují postupy pro sestavení, určení velikosti, instalaci, použití a péči. Ukažte fyzickou orientaci, pokud ji slova nemohou bezpečně popsat.
- Místní služba . Průvodci přípravou pomáhají zákazníkům shromáždit vstupy a pochopit schůzky. Oddělte bezpečnou práci zákazníka od práce vyhrazené kvalifikovanému odborníkovi.
- Tržiště . Prodejci, kupující, poskytovatelé a správci mohou mít různé pracovní postupy. Uveďte publikum a roli ještě před předpoklady.
- B2B služby . Průvodci onboardingem, schvalováním, předáváním a revizí objasňují vlastnictví a ukazují, jak vypadá dokončená práce.
- Mediální vydavatelé a affiliate partneři . Odborné výukové články mohou sloužit poptávce vedené úkoly, ale vydavatelé musí postup otestovat a udržovat snímky, místo aby přepisovali dokumentaci dodavatele.
Vyhledávací záměr
Vyhledávací záměr je výsledek, který osoba očekává od dotazu. U procedurálního záměru je očekávaný tvar odpovědi okamžitá kontrola proveditelnosti následovaná proveditelnou cestou: výsledek, čas, obtížnost, předpoklady, uspořádané akce, ověření, řešení problémů a další krok.
Výsledky úkolů mohou míchat videa, úryvky kroků, produktovou dokumentaci, komunitní odpovědi a výukové články. AI odpovědi často komprimují cestu do očíslované posloupnosti se zdroji. Každý extrahovaný krok si musí zachovat svůj objekt, podmínku a očekávaný výsledek; varování musí být umístěna před rizikové akce.
Oba příklady zachyťte ke stejnému datu a zaznamenejte dotaz, lokalitu, zařízení, stav přihlášení a rozhraní. Výsledky se mění; poučení o designu by mělo vycházet z tvaru odpovědi, nikoli z tvrzení, že jeden poskytovatel vždy zobrazuje určitou funkci.
Struktura stránky
Rozsahy slov řídí důraz, nikoli kvóty. Přidávejte slova pouze tehdy, když odstraňují rozhodnutí, které by jinak čtenář musel učinit sám.
| Sekce | Rozsah slov | Účel | Stav |
|---|---|---|---|
| Hero a přímá odpověď | 60–100 | Uveďte výsledek, čtenáře, výchozí stav, čas a obtížnost. | Povinné |
| Předpoklady | 120–220 | Uveďte přístup, nástroje, vstupy, náklady, verze, bezpečnostní podmínky a nevratné závazky před zahájením práce. | Povinné |
| Rychlý přehled | 60–120 | Nahlédněte do hlavních fází a konečného stavu úspěchu, aniž byste duplikovali každý pokyn. | Povinné |
| Uspořádaný postup | 700–1 500 | Proveďte čtenáře imperativními, odůvodněnými, testovatelnými a obnovitelnými kroky. | Povinné |
| Kontrola dokončení | 100–180 | Ověřte konečný výsledek pozorovatelnými důkazy a uveďte, co „hotovo“ zahrnuje. | Povinné |
| Řešení problémů | 250–500 | Vyřešte běžné selhání tohoto postupu podle příznaku, pravděpodobné příčiny a dalšího kroku. | Povinné |
| Varianty | 150–350 | Vysvětlete významné rozdíly v tarifu, zařízení, roli nebo verzi. | Podmíněné |
| FAQ | 200–350 | Odpovězte na zbytkové otázky, které nepatří do kroku. | Povinné; 5–7 otázek |
| CTA | 40–90 | Nabídněte jednu logickou akci poté, co čtenář dokončí nebo vyhodnotí úkol. | Povinné |
Povinné prvky
Seznam kroků nese smlouvu o postupu. Předpoklady chrání jeho výchozí stav a závěrečná kontrola dokazuje slíbený výsledek; ani jeden nemá samostatnou stránku prvku, proto zůstávají pojmenovanými strukturálními sekcemi, nikoli vynalezenými prvky.
| Prvek | Stav | Přesné umístění | Proč tam patří |
|---|---|---|---|
| seznam kroků | Vždy | Po předpokladech a rychlém přehledu | Posloupnost je hlavním přínosem stránky; každý krok obsahuje důvod, akci, úspěch a obnovu. |
| Popisný snímek obrazovky | Podmíněně | Ihned po instrukci, jejíž rozhraní nebo stav je nejednoznačný | Snímek řeší prostorovou nejednoznačnost pouze tehdy, pokud zůstává vedle příslušné akce. |
| Tip box | Podmíněně | Po povinné instrukci, kterou vylepšuje | Volitelná optimalizace nesmí být zaměněna za podmínku úspěchu. |
| Varovný box | Podmíněně, povinně pokud existuje riziko | Před rizikovou nebo nevratnou akcí | Varování může změnit chování pouze před spuštěním důsledku. |
| Struktura FAQ | Vždy | Po řešení problémů, před CTA | Zbytkové otázky patří po úplném postupu, aby odpovědi neroztříštily posloupnost. |
| CTA blok | Vždy | Poslední obsahový blok | Další akce se stává rozumnou až poté, co stránka doručila slíbený výsledek. |
Kdy jsou snímky obrazovky povinné
Snímek obrazovky je povinný, když text nemůže spolehlivě identifikovat správný ovládací prvek, umístění, stav, orientaci nebo výsledek. Použijte jej pro podobné ovládací prvky, skrytá nastavení, neoznačené vizuální stavy nebo fyzické části, které by mohly být zaměněny. Ořízněte na rozhodovací oblast, zachovejte kontext orientace, označte cíl a vysvětlete jej v textu.
Snímek obrazovky je šum, když opakuje „Vyberte Uložit“, ukazuje celou obrazovku kvůli jednomu zřejmému ovládacímu prvku nebo nahrazuje text. Nikdy nenechávejte obrázek jako jediný zdroj příkazu, varování, hodnoty nebo kritéria úspěchu.
Frontmatter
Frontmatter musí popisovat postup stejně přesně jako viditelná stránka.
| Pole | Povinná hodnota nebo pravidlo |
|---|---|
entity | Stabilní hodnota sloveso–objekt pro daný úkol, například connect-google-search-console, nikoli široké téma search-console. |
schemaType | HowTo pokud je viditelná stránka uspořádaný postup s výsledkem; jinak Article. |
name | Stejný název úkolu, který čtenáři vidí v titulku nebo přímé odpovědi. |
description | Stručný výsledek a rozsah, nikoli seznam klíčových slov. |
totalTime | Poctivé trvání ve formátu ISO 8601 odvozené z otestovaného času dokončení; dobu čekání uveďte zvlášť ve viditelném textu. |
estimatedCost | Zahrňte pouze tehdy, když postup vyžaduje nákup nebo poplatek, s uvedením viditelné částky a měny. |
supply a tool | Uvádějte pouze položky pojmenované ve viditelných předpokladech. Přístup k softwaru nenazývejte fyzickým materiálem. |
step | Stejný počet, pořadí, názvy, text, URL a obrázky jako viditelné kroky. |
inLanguage a data | Odpovídají publikačnímu jazyku a viditelnému záznamu o publikaci nebo úpravě. |
| FAQ | Použijte 5–7 skutečných zbytkových otázek v [[faq]]; jakýkoli viditelný accordion a strukturovaná data se s nimi musí přesně shodovat. |
Schema markup
jsou strojově čitelná data o viditelném obsahu. Publikujte HowTo jako JSON-LD
pouze tehdy, když je implementace věrná. Nikdy neoznačujte předpoklad jako krok, neslučujte viditelné kroky, nepřidávejte skryté instrukce ani nepřipojujte špatný obrázek. Použijte Article, pokud nelze udržet přesnou shodu.
Úplný příklad
Tato kostra určená ke kopírování a vkládání používá reálný úkol. Výrobní pokyny v hranatých závorkách specifikují důkazy, které musí autor vložit.
# Jak připojit Google Search Console k Northstar Analytics
Připojte ověřenou vlastnost Search Console k Northstar Analytics, aby se mohl importovat první report dotazů. Správce účtu může nastavení dokončit asi za 15 minut; import může trvat až dalších 30 minut. Obtížnost: začátečník.
## Než začnete
- Účet Northstar Analytics s rolí Správce
- Vlastnický přístup k vlastnosti Search Console, kterou budete připojovat
- Přesná HTTPS vlastnost, která odpovídá kanonickému hostiteli webu
- Oprávnění ke sdílení dat o výkonu Search Console s Northstar Analytics
Nepokračujte s testovací vlastností nebo jiným hostitelem. Připojení může technicky uspět, zatímco importuje data pro nesprávný web.
## Rychlý přehled
Vyberete web, autorizujete přístup, zvolíte odpovídající vlastnost, spustíte import a ověříte, že se v Northstar Analytics objeví řádek dotazu s datem.
## 1. Potvrďte shodu webu a vlastnosti
**Proč tento krok existuje:** Search Console může obsahovat doménové vlastnosti a vlastnosti s předponou URL s podobnými názvy. Výběr špatné vytvoří platné připojení s irelevantními nebo neúplnými daty.
**Co udělat:** V Northstar Analytics otevřete stránku Nastavení webu a zkopírujte jeho kanonického hostitele. V Search Console potvrďte, že zamýšlená vlastnost zahrnuje tohoto hostitele a protokol.
**Když to fungovalo:** Hostitel zobrazený v obou produktech se přesně shoduje, včetně `www` a HTTPS.
**Pokud nefungovalo:** Zeptejte se vlastníka vlastnosti, která vlastnost reprezentuje produkci. Nehádejte podle zobrazovaného názvu.
## 2. Spusťte připojení Search Console
**Proč tento krok existuje:** Spuštění z vybraného webu váže autorizaci ke správnému pracovnímu prostoru Northstar Analytics.
**Co udělat:** Otevřete **Nastavení → Integrace → Google Search Console**, poté vyberte **Připojit**.
**Když to fungovalo:** Okno autorizace Google pojmenuje Northstar Analytics a požádá vás o výběr účtu.
**Pokud nefungovalo:** Povolte vyskakovací okna a zkuste znovu. Pokud je Připojit neaktivní, potvrďte svou roli Správce.
[Vložte oříznutý popisný snímek panelu Integrace pouze tehdy, když je Připojit obtížné rozeznat od jiného ovládacího prvku.]
## 3. Autorizujte správný Google účet
**Proč tento krok existuje:** Northstar může zobrazit pouze vlastnosti, ke kterým má autorizovaný Google účet přístup.
**Co udělat:** Vyberte Google účet, který vlastní zamýšlenou vlastnost, zkontrolujte požadovaný přístup a schválte jej.
**Když to fungovalo:** Vrátíte se do Northstar Analytics a uvidíte výběr vlastnosti.
**Pokud nefungovalo:** Použijte soukromé okno a opakujte autorizaci s účtem vlastníka vlastnosti.
## 4. Vyberte produkční vlastnost
**Proč tento krok existuje:** Autorizace dokazuje přístup k účtu, ale vybraná vlastnost určuje, která data se importují.
**Co udělat:** Vyberte vlastnost, která přesně odpovídá kanonickému hostiteli z kroku 1, poté zvolte **Uložit a importovat**.
**Když to fungovalo:** Stav integrace se změní na **Import zařazen do fronty** a zobrazí vybranou vlastnost.
**Pokud nefungovalo:** Vraťte se ke kroku 3 s autorizovaným účtem. Porovnejte úplné identifikátory, když vlastnosti vypadají podobně.
## 5. Ověřte první import
**Proč tento krok existuje:** Odznak připojení dokazuje autorizaci, nikoli že použitelná data dorazila do reportu.
**Co udělat:** Po uplynutí zobrazené čekací doby otevřete **Reporty → Vyhledávací dotazy** a nastavte datový rozsah na období, které má data v Search Console.
**Když to fungovalo:** Alespoň jeden řádek zobrazuje dotaz, vstupní stránku, datum, kliknutí nebo imprese z vybrané vlastnosti.
**Pokud nefungovalo:** Pro **Import zařazen do fronty** počkejte a zkuste znovu. Pro **Platnost oprávnění vypršela** se znovu připojte. Pro **Žádná data** zkontrolujte datový rozsah a zdrojovou vlastnost.
## Kontrolní seznam dokončení
- Integrace uvádí zamýšlenou produkční vlastnost.
- Její stav je Připojeno, nikoli pouze Ve frontě.
- Report dotazů obsahuje řádek s datem z této vlastnosti.
- Druhý správce může identifikovat, který účet vlastní připojení.
## Řešení problémů
### Výběr vlastnosti je prázdný
Autorizovanému Google účtu chybí přístup nebo byl přístup odebrán. Znovu autorizujte s vlastníkem vlastnosti, poté obnovte výběr.
### Připojení je úspěšné, ale report je prázdný
Porovnejte datový rozsah reportu s Search Console, poté potvrďte přesný identifikátor vlastnosti před odpojením.
### Import se opakovaně vrací do fronty
Zaznamenejte web, identifikátor vlastnosti, čas spuštění a nejnovější stav, poté kontaktujte podporu. Tyto podrobnosti umožní podpoře zkontrolovat import, aniž by vás žádala o slepé opakování autorizace.
## FAQ
[Přidejte pět až sedm zbytkových otázek o oprávněních, zpoždění dat, typech vlastností, opětovném připojení a odstranění. Neopakujte kroky.]
## Další kroky
[Nabídněte jednu akci, která využívá importovaná data, například prohlédnutí prvního reportu příležitostí dotazů.]
Příklady designu
Každá varianta galerie musí zobrazovat stejné předpoklady, pět kroků, stavy úspěchu, text pro obnovu, řešení problémů a kontrolu dokončení.
Kontrolní seznam kvality
Průvodce je publikovatelný pouze tehdy, když jej recenzent může dokončit z čistého výchozího stavu bez autora.
- Hero uvádí jeden testovatelný výsledek, zamýšleného čtenáře, očekávaný aktivní čas, čekací dobu a obtížnost.
- Předpoklady uvádějí role, přístup, verze, nástroje, vstupy, poplatky a bezpečnostní podmínky, které by mohly blokovat pozdější krok.
- Každý krok začíná imperativním názvem a vysvětluje proč, akci, úspěch a obnovu.
- Pořadí bylo otestováno; přesunutí kroku by změnilo, zablokovalo nebo zneplatnilo výsledek.
- Varování se objevují před rizikem a volitelné tipy nikdy neskrývají povinnou práci.
- Snímky obrazovky řeší skutečnou nejednoznačnost, mají aktuální kontext rozhraní a přístupná vysvětlení a nejsou jediným zdrojem instrukcí.
- Závěrečná kontrola ověřuje slíbený výsledek, nikoli poslední kliknutí.
- Řešení problémů pokrývá pozorovaná nebo věrohodně reprodukovatelná selhání s konkrétními dalšími kroky.
- HowTo data odpovídají každému viditelnému kroku a vlastnosti přesně, nebo stránka používá Article.
- Druhý tester dokončil průvodce na podporovaném účtu, zařízení, roli a verzi.
Časté chyby
Nejčastějším selháním je přepis kliknutí: „Otevřete Nastavení. Klikněte na Integrace. Klikněte na Připojit.“ Chybí proč na vlastnosti záleží, co by se mělo objevit a jak se zotavit z chybějícího oprávnění.
Další chyby jsou stejně specifické:
- Skrývání předpokladů uvnitř kroků. Zjistit v kroku 4, že získání administrátorského přístupu trvá den, plýtvá časem čtenáře a může zanechat nedokončenou práci.
- Umístění varování za akce. Varování o smazání pod tlačítkem Smazat nemůže zabránit smazání.
- Použití uplynulého času jako aktivního času. „Trvá 40 minut“ je zavádějící, když práce trvá 10 minut plus 30minutový import. Uveďte obojí.
- Testování pouze autorova účtu. Správci často vidí ovládací prvky, které běžní členové nevidí. Otestujte roli uvedenou v hero sekci.
- Považování posledního kliknutí za úspěch. „Uloženo“ může znamenat pouze to, že požadavek byl přijat. Ověřte následující stav nebo výstup.
- Nesoulad schématu. Přejmenování, přeuspořádání nebo sloučení viditelných kroků bez aktualizace HowTo dat vytváří dva nekompatibilní postupy na jedné URL.
Interní propojování
Návod odkazuje ven pouze tehdy, když cíl vysvětluje předpoklad, podporuje rozhodnutí nebo poskytuje další postup. Definujte odborné termíny před posloupností nebo při prvním použití.
Ostatní stránky by měly odkazovat na průvodce, když pojmenovávají přesný úkol, ale neměly by duplikovat jeho kroky. Produktová stránka může odkázat z funkce na nastavení. Ultimátní průvodce může odkázat z široké fáze na příslušný postup. Článek o řešení problémů může odkázat zpět na výchozí stav průvodce po vyřešení příznaku.
Neduplikujte rozhodovacího průvodce „jak vybrat“, cestu řešení problémů vedenou příznakem nebo obecnou dokumentaci. Pokud sesterská stránka potřebuje více než krátké shrnutí stejné posloupnosti, stanovte jeden kanonický postup a odkažte na něj. Udržujte varianty specifické pro verzi na jedné stránce, pokud je hlavní cesta sdílená; rozdělte je pouze tehdy, když se kroky nebo předpoklady materiálně liší.
Jak měřit výsledky
Měření navazuje na slib průvodce: byl postup nalezen pro zamýšlený úkol, vybrán jako užitečný zdroj, následován a propojen s smysluplným dalším stavem? Použijte AI rank tracking ke sledování opakujících se dotazů ve tvaru cíle, poté prozkoumejte Prompt Tracking pro znění odpovědi, citovanou URL, engine a konkurenční zdroje. Funkční přímý odkaz je otevřít Prompt Tracking .
Zaznamenejte sadu promptů a výchozí stav před publikací. Sledujte citace odděleně od zmínek značky. Na webu používejte důkazy o dokončení, jako je dosažení závěrečné kontroly, výběr CTA pro další krok, dokončení související produktové události nebo snížená poptávka po podpoře. Každý z nich je důkaz, nikoli důkaz; hloubka rolování nemůže ukázat, že postup fungoval.
FAQ
Často kladené otázky
Čím se liší návod od dokumentace?
Potřebuje každý krok snímek obrazovky?
Kolik kroků by měl mít návod?
Měl by návod obsahovat HowTo schéma?
Kde by se mělo objevit řešení problémů?
Jak by měl tým měřit výkonnost návodu?
Uveďte průvodce do provozu
Otestujte postup s reprezentativním čtenářem, poté použijte CTA blok k nabídnutí jedné akce, která přirozeně vyplývá z ověřeného dokončení.
Další návody v této sekci
Připraveni uvést to do praxe?
Bezplatná kontrola · 7denní zkušební verze · bez platební karty