How-To-gidsen: structuur, stappen en schema
Bouw een how-to-gids die het doel van een lezer omzet in geordende, testbare stappen met vereisten, succescriteria, herstelroutes en probleemoplossing.
Een how-to-gids is een geordende procedure die een lezer van een bekende uitgangssituatie naar een geverifieerd resultaat brengt. Het beantwoordt de vraag “Hoe voer ik deze taak uit?” zonder dat de lezer een ontbrekende stap zelf moet bedenken.
Elke stap heeft een imperatieve titel, de reden ervan, de handeling, een waarneembare successtatus en een herstelpad. Alleen-klik-instructies werken alleen wanneer het account, de toegang, de gegevens en de interface van de lezer toevallig overeenkomen met de aannames van de auteur.
Beantwoorde lezersvraag: “Wat heb ik nodig, wat doe ik in welke volgorde, hoe weet ik dat het heeft gewerkt en hoe herstel ik het als het niet heeft gewerkt?”
Vragen die het beantwoordt
Een how-to-gids dient informatie-intentie , wat betekent dat de lezer probeert te leren of een taak uit te voeren in plaats van een lijst met producten te evalueren. De zoekopdracht begint vaak met “hoe”, maar bewoording alleen is niet voldoende. Het beoogde resultaat moet iets zijn dat de lezer kan uitvoeren en verifiëren.
Schrijf voor de vragen die mensen daadwerkelijk meenemen naar de procedure:
- “Heb ik het vereiste abonnement, de toegang, de tools en de tijd?”
- “Welke handelingen moeten in volgorde gebeuren en wat zou er na elke handeling moeten verschijnen?”
- “Kan dit iets overschrijven, publiceren, in rekening brengen, verwijderen of blootleggen?”
- “Hoe herstel ik van een ander resultaat en bevestig ik dat de volledige taak is gelukt?”
Het directe antwoord moet het resultaat, de beginsituatie, de verwachte tijd en de moeilijkheidsgraad vermelden vóór de eerste lange uitleg. “In ongeveer 20 minuten kan een accountbeheerder Search Console verbinden en de eerste succesvolle import verifiëren” is nuttig. “Deze gids verkent integratiebest practices” is dat niet.
Wanneer dit berichttype te gebruiken
Procedures mislukken op aannamegrenzen. De auteur weet welke toegang, vertraging of instelling ertoe doet; de lezer niet. Dit formaat maakt verborgen afhankelijkheden, statuswijzigingen en herstelbeslissingen zichtbaar in volgorde.
| Verwarrend type | Kies het wanneer de lezer begint met | Antwoordvorm | Waarom het niet dit type is |
|---|---|---|---|
| How-to-gids | Een doel: “Ik moet X voltooien” | Vereisten, geordende stappen, succescriteria, herstel, voltooiingscontrole | Het is de procedure zelf. |
| Hoe X te kiezen | Een beslissing: “Welke X past bij mij?” | Criteria, alternatieven, afwegingen, aanbeveling | “Kiezen” beschrijft evaluatie, geen actiereeks met een testbaar resultaat. |
| Probleemoplossingsartikel | Een symptoom: “X is mislukt” of “Ik zie fout Y” | Diagnoseboom van symptoom naar oorzaak naar oplossing | Het begint nadat een geprobeerde procedure al een probleem heeft veroorzaakt. |
| Documentatieartikel | Een behoefte om gedrag, velden, limieten of syntax op te zoeken | Referentie geordend voor opzoeken in plaats van één leespad | Het ondersteunt veel taken en belooft niet één verhalende route naar één uitkomst. |
Kies alleen voor een how-to wanneer volgorde ertoe doet. Als onafhankelijke controles in elke volgorde kunnen worden uitgevoerd, publiceer dan een checklist. Als het onderwerp breed genoeg is om meerdere verschillende doelen te bevatten, gebruik dan een ultieme gids als overzicht en maak aparte how-to-gidsen voor de procedures. Als de lezer vooral vraagt wat een concept betekent, gebruik dan een wat-is-X-pagina .
Het beste voor deze bedrijfstypen
De rangschikking weerspiegelt hoe vaak het model afhankelijk is van een lezer die een herhaalbaar proces voltooit, niet de algehele waarde van content voor het bedrijf.
- SaaS . Installatie, configuratie, migratie en terugkerende workflows bepalen of gebruikers waarde bereiken. Maak onderscheid tussen abonnementslimieten, rollen, interfacestatussen en destructieve wijzigingen.
- Ecommerce . Kopers hebben montage-, maatvoerings-, installatie-, gebruiks- en onderhoudsprocedures nodig. Toon fysieke oriëntatie wanneer woorden dit niet veilig kunnen doen.
- Lokale dienstverlening . Voorbereidingsgidsen helpen klanten om invoer te verzamelen en afspraken te begrijpen. Scheid veilig klantwerk van werk dat is voorbehouden aan een gekwalificeerde professional.
- Marktplaatsen . Verkopers, kopers, aanbieders en beheerders kunnen verschillende workflows volgen. Vermeld het publiek en de rol vóór de vereisten.
- B2B-diensten . Onboarding-, goedkeurings-, overdrachts- en reviewgidsen verduidelijken eigenaarschap en tonen hoe voltooid werk eruitziet.
- Media-uitgevers en affiliates . Expertzelfstudies kunnen vraag op taakniveau bedienen, maar uitgevers moeten de procedure testen en opnames onderhouden in plaats van leveranciersdocumentatie te herschrijven.
Zoekintentie
Zoekintentie is de uitkomst die een persoon verwacht van een zoekopdracht. Voor procedurele intentie is de verwachte antwoordvorm een directe haalbaarheidscheck gevolgd door een uitvoerbare route: resultaat, tijd, moeilijkheidsgraad, vereisten, geordende handelingen, verificatie, probleemoplossing en volgende stap.
Taakresultaten kunnen video’s, stapextracten, productdocumentatie, communityantwoorden en zelfstudies combineren. AI-antwoorden comprimeren de route vaak in een genummerde reeks met bronnen. Elke geëxtraheerde stap moet zijn object, conditie en verwachte resultaat behouden; waarschuwingen moeten voor risicovolle handelingen staan.
Leg beide voorbeelden vast op dezelfde datum en noteer de zoekopdracht, locatie, apparaat, ingelogde status en interface. Resultaten veranderen; de ontwerples moet komen van de antwoordvorm, niet van een bewering dat één aanbieder altijd een bepaalde functie toont.
Paginastructuur
Woordbereiken bepalen nadruk, geen quota’s. Voeg alleen woorden toe wanneer ze een beslissing wegnemen die de lezer anders alleen zou moeten maken.
| Sectie | Woordbereik | Doel | Status |
|---|---|---|---|
| Hero en direct antwoord | 60–100 | Benoem het resultaat, de lezer, beginsituatie, tijd en moeilijkheidsgraad. | Verplicht |
| Vereisten | 120–220 | Vermeld toegang, tools, invoer, kosten, versies, veiligheidsvoorwaarden en onomkeerbare verplichtingen voordat het werk begint. | Verplicht |
| Snel overzicht | 60–120 | Geef een voorproefje van de belangrijkste fases en de uiteindelijke successtatus zonder elke instructie te herhalen. | Verplicht |
| Geordende procedure | 700–1.500 | Leid de lezer door imperatieve, beredeneerde, testbare, herstelbare stappen. | Verplicht |
| Voltooiingscontrole | 100–180 | Verifieer het eindresultaat met waarneembaar bewijs en vermeld wat “voltooid” omvat. | Verplicht |
| Probleemoplossing | 250–500 | Los veelvoorkomende fouten van deze procedure op per symptoom, waarschijnlijke oorzaak en volgende actie. | Verplicht |
| Variaties | 150–350 | Leg betekenisvolle verschillen in abonnement, apparaat, rol of versie uit. | Voorwaardelijk |
| FAQ | 200–350 | Beantwoord resterende vragen die niet in een stap thuishoren. | Verplicht; 5–7 vragen |
| CTA | 40–90 | Bied één logische actie aan nadat de lezer de taak heeft voltooid of geëvalueerd. | Verplicht |
Verplichte elementen
De stappenlijst beheert het procedurecontract. Vereisten beschermen de beginsituatie en de afsluitende controle bewijst het beloofde resultaat; geen van beide heeft een aparte elementpagina, dus blijven ze benoemde structurele secties in plaats van verzonnen elementen.
| Element | Status | Exacte positie | Waarom het daar hoort |
|---|---|---|---|
| stappenlijst | Altijd | Na vereisten en het snel overzicht | De reeks is de kernlevering van de pagina; elke stap bevat reden, handeling, succes en herstel. |
| Geannoteerde screenshot | Voorwaardelijk | Direct na de instructie waarvan de interface of status dubbelzinnig is | Een opname lost ruimtelijke dubbelzinnigheid alleen op zolang deze naast de relevante handeling blijft. |
| Tipbox | Voorwaardelijk | Na de verplichte instructie die het verbetert | Optionele optimalisatie mag niet worden aangezien voor een succesvoorwaarde. |
| Waarschuwingsbox | Voorwaardelijk, verplicht wanneer risico bestaat | Vóór de risicovolle of onomkeerbare handeling | Een waarschuwing kan gedrag alleen veranderen voordat de consequentie wordt geactiveerd. |
| FAQ-structuur | Altijd | Na probleemoplossing, vóór de CTA | Resterende vragen horen na de volledige procedure, zodat antwoorden de reeks niet fragmenteren. |
| CTA-blok | Altijd | Laatste contentblok | De volgende actie wordt pas redelijk nadat de pagina het beloofde resultaat heeft geleverd. |
Wanneer screenshots verplicht zijn
Een screenshot is verplicht wanneer tekst niet betrouwbaar het juiste besturingselement, de locatie, status, oriëntatie of het resultaat kan identificeren. Gebruik er een voor vergelijkbare besturingselementen, verborgen instellingen, ongelabelde visuele statussen of fysieke onderdelen die verward kunnen worden. Snijd bij tot het beslissingsgebied, behoud oriëntatiecontext, markeer het doel en leg het uit in tekst.
Een screenshot is ruis wanneer het “Selecteer Opslaan” herhaalt, een volledig scherm toont voor één voor de hand liggend besturingselement of tekst vervangt. Maak nooit een afbeelding de enige bron van een opdracht, waarschuwing, waarde of succesvoorwaarde.
Frontmatter
De frontmatter moet de procedure net zo precies beschrijven als de zichtbare pagina.
| Veld | Vereiste waarde of regel |
|---|---|
entity | Een stabiele werkwoord-objectwaarde voor de taak, zoals connect-google-search-console, niet het brede onderwerp search-console. |
schemaType | HowTo wanneer de zichtbare pagina een geordende procedure met een resultaat is; anders Article. |
name | Dezelfde taaknaam die lezers zien in de titel of het directe antwoord. |
description | Beknopt resultaat en reikwijdte, geen lijst met trefwoorden. |
totalTime | Eerlijke ISO 8601-duur afgeleid van geteste voltooiingstijd; aparte wachttijd in zichtbare tekst. |
estimatedCost | Alleen opnemen wanneer de procedure een aankoop of vergoeding vereist, met het zichtbare bedrag en de valuta. |
supply en tool | Alleen items vermelden die in de zichtbare vereisten worden genoemd. Noem softwaretoegang geen fysieke benodigdheid. |
step | Zelfde aantal, volgorde, namen, tekst, URL’s en afbeeldingen als de zichtbare stappen. |
inLanguage en datums | Komen overeen met de gepubliceerde taal en zichtbare publicatie- of wijzigingsdatum. |
| FAQ | Gebruik 5–7 echte resterende vragen in [[faq]]; elke zichtbare accordeon en gestructureerde data moeten er exact mee overeenkomen. |
Schemamarkup
is machineleesbare data over zichtbare content. Publiceer HowTo als JSON-LD
alleen wanneer de implementatie getrouw is. Markeer nooit een vereiste als een stap, voeg zichtbare stappen samen, voeg verborgen instructies toe of koppel de verkeerde afbeelding. Gebruik Article wanneer exacte overeenkomst niet kan worden gehandhaafd.
Volledig voorbeeld
Dit kopieer-plakbare skelet gebruikt een echte taak. Tussen haakjes geplaatste productieprompts specificeren het bewijs dat een schrijver moet invoegen.
# Hoe Google Search Console te verbinden met Northstar Analytics
Verbind een geverifieerd Search Console-eigendom met Northstar Analytics zodat het eerste queryrapport kan importeren. Een accountbeheerder kan de installatie in ongeveer 15 minuten voltooien; de import kan tot 30 extra minuten duren. Moeilijkheidsgraad: beginner.
## Voordat je begint
- Een Northstar Analytics-account met de rol Beheerder
- Eigenaarstoegang tot het Search Console-eigendom dat je gaat verbinden
- Het exacte HTTPS-eigendom dat overeenkomt met de canonieke host van de site
- Toestemming om Search Console-prestatiegegevens te delen met Northstar Analytics
Ga niet verder met een test-eigendom of een andere host. De verbinding kan technisch slagen terwijl er gegevens voor de verkeerde site worden geïmporteerd.
## Snel overzicht
Je selecteert de site, autoriseert toegang, kiest het bijpassende eigendom, start de import en verifieert dat een gedateerde queryrij verschijnt in Northstar Analytics.
## 1. Bevestig dat de site en het eigendom overeenkomen
**Waarom deze stap bestaat:** Search Console kan domein- en URL-voorvoegseleigendommen bevatten met vergelijkbare namen. Het verkeerde kiezen levert een geldige verbinding op met irrelevante of onvolledige gegevens.
**Doe dit:** Open in Northstar Analytics de instellingenpagina van de site en kopieer de canonieke host. Bevestig in Search Console dat het beoogde eigendom die host en dat protocol bevat.
**Wanneer het werkte:** De host die in beide producten wordt getoond, komt exact overeen, inclusief `www` en HTTPS.
**Als het niet werkte:** Vraag de eigenaar van het eigendom welk eigendom de productieomgeving vertegenwoordigt. Raad niet op basis van de weergavenaam.
## 2. Start de Search Console-verbinding
**Waarom deze stap bestaat:** Door te starten vanaf de geselecteerde site wordt de autorisatie gekoppeld aan de juiste Northstar Analytics-werkruimte.
**Doe dit:** Open **Instellingen → Integraties → Google Search Console** en selecteer **Verbinden**.
**Wanneer het werkte:** Een Google-autorisatievenster noemt Northstar Analytics en vraagt je een account te kiezen.
**Als het niet werkte:** Sta pop-ups toe en probeer opnieuw. Als Verbinden is uitgeschakeld, bevestig dan je beheerdersrol.
[Voeg een bijgesneden, geannoteerde opname van het Integraties-paneel in alleen wanneer Verbinden moeilijk te onderscheiden is van een ander besturingselement.]
## 3. Autoriseer het juiste Google-account
**Waarom deze stap bestaat:** Northstar kan alleen eigendommen weergeven waartoe het geautoriseerde Google-account toegang heeft.
**Doe dit:** Kies het Google-account dat eigenaar is van het beoogde eigendom, bekijk de gevraagde toegang en keur deze goed.
**Wanneer het werkte:** Je keert terug naar Northstar Analytics en ziet een eigendomskiezer.
**Als het niet werkte:** Gebruik een privévenster en herhaal de autorisatie met het account van de eigendomseigenaar.
## 4. Selecteer het productie-eigendom
**Waarom deze stap bestaat:** Autorisatie bewijst accounttoegang, maar het geselecteerde eigendom bepaalt welke gegevens worden geïmporteerd.
**Doe dit:** Selecteer het eigendom dat exact overeenkwam met de canonieke host in stap 1 en kies **Opslaan en importeren**.
**Wanneer het werkte:** De integratiestatus verandert naar **Import in wachtrij** en toont het geselecteerde eigendom.
**Als het niet werkte:** Keer terug naar stap 3 met een geautoriseerd account. Vergelijk volledige identificatiegegevens wanneer eigendommen op elkaar lijken.
## 5. Verifieer de eerste import
**Waarom deze stap bestaat:** Een verbonden badge bewijst autorisatie, niet dat bruikbare gegevens het rapport hebben bereikt.
**Doe dit:** Open na de weergegeven wachttijd **Rapporten → Zoekopdrachten** en stel het datumbereik in op een periode die Search Console-gegevens heeft.
**Wanneer het werkte:** Ten minste één rij toont een query, bestemmingspagina, datum, klikken of vertoningen van het geselecteerde eigendom.
**Als het niet werkte:** Wacht bij **Import in wachtrij** en probeer opnieuw. Bij **Toestemming verlopen** opnieuw verbinden. Bij **Geen gegevens** controleer het datumbereik en broneigendom.
## Voltooiingschecklist
- De integratie vermeldt het beoogde productie-eigendom.
- De status is Verbonden in plaats van alleen In wachtrij.
- Het queryrapport bevat een gedateerde rij van dat eigendom.
- Een tweede beheerder kan identificeren welk account de verbinding bezit.
## Probleemoplossing
### De eigendomskiezer is leeg
Het geautoriseerde Google-account heeft geen toegang of de toegang is verwijderd. Autoriseer opnieuw met een eigendomseigenaar en laad de kieser opnieuw.
### De verbinding slaagt maar het rapport is leeg
Vergelijk het rapportdatumbereik met Search Console en bevestig vervolgens de exacte eigendomsidentificatie voordat je de verbinding verbreekt.
### De import keert herhaaldelijk terug naar Wachtrij
Noteer de site, eigendomsidentificatie, starttijd en laatste status en neem contact op met ondersteuning. Deze gegevens laten ondersteuning toe om de import te inspecteren zonder je te vragen blindelings autorisatie te herhalen.
## FAQ
[Voeg vijf tot zeven resterende vragen toe over machtigingen, gegevensvertraging, eigendomstypen, herverbinding en verwijdering. Herhaal de stappen niet.]
## Volgende stappen
[Bied één actie aan die de geïmporteerde gegevens gebruikt, zoals het bekijken van het eerste querykansenrapport.]
Ontwerpvoorbeelden
Elke galerijvariant moet dezelfde vereisten, vijf stappen, successtatussen, hersteltekst, probleemoplossing en voltooiingscontrole tonen.
Kwaliteitscontrolelijst
Een gids is pas publiceerbaar wanneer een beoordelaar deze kan voltooien vanuit een schone beginsituatie zonder de auteur.
- De hero vermeldt één testbare uitkomst, de beoogde lezer, verwachte actieve tijd, wachttijd en moeilijkheidsgraad.
- Vereisten benoemen rollen, toegang, versies, tools, invoer, kosten en veiligheidsvoorwaarden die een latere stap zouden kunnen blokkeren.
- Elke stap begint met een imperatieve titel en legt waarom, handeling, succes en herstel uit.
- De volgorde is getest; het verplaatsen van een stap zou het resultaat veranderen, blokkeren of ongeldig maken.
- Waarschuwingen verschijnen vóór risico en optionele tips verbergen nooit vereist werk.
- Screenshots lossen echte dubbelzinnigheid op, hebben actuele interfacecontext en toegankelijke uitleg, en zijn niet de enige bron van instructies.
- De eindcontrole verifieert de beloofde uitkomst in plaats van de laatste klik.
- Probleemoplossing dekt waargenomen of geloofwaardig reproduceerbare fouten met specifieke volgende acties.
- HowTo-gegevens komen exact overeen met elke zichtbare stap en elk eigendom, of de pagina gebruikt in plaats daarvan Article.
- Een tweede tester heeft de gids voltooid op het ondersteunde account, apparaat, rol en versie.
Veelgemaakte fouten
De meest voorkomende fout is een kliktranscript: “Open Instellingen. Klik op Integraties. Klik op Verbinden.” Het laat na waarom het eigendom ertoe doet, wat er zou moeten verschijnen en hoe te herstellen van ontbrekende machtiging.
Andere fouten zijn even specifiek:
- Vereisten verbergen in stappen. Ontdekken bij stap 4 dat beheerderstoegang een dag duurt om te verkrijgen, verspilt de tijd van de lezer en kan gedeeltelijk werk strandzetten.
- Waarschuwingen na handelingen plaatsen. Een verwijderingswaarschuwing onder de Verwijder-instructie kan verwijdering niet voorkomen.
- Verstreken tijd gebruiken als actieve tijd. “Duurt 40 minuten” is misleidend wanneer het werk 10 minuten plus een import van 30 minuten duurt. Vermeld beide.
- Alleen het account van de auteur testen. Beheerders zien vaak besturingselementen die gewone leden niet zien. Test de rol die in de hero wordt genoemd.
- De laatste klik als succes behandelen. “Opgeslagen” kan alleen betekenen dat een verzoek is geaccepteerd. Verifieer de downstream-status of uitvoer.
- Schema laten afwijken. Het hernoemen, herordenen of samenvoegen van zichtbare stappen zonder HowTo-gegevens bij te werken, creëert twee incompatibele procedures op één URL.
Interne koppeling
Een how-to linkt alleen naar buiten wanneer de bestemming een vereiste uitlegt, een beslissing ondersteunt of de volgende procedure biedt. Definieer specialistische termen vóór de reeks of bij het eerste gebruik.
Andere pagina’s moeten naar de gids linken wanneer ze de exacte taak noemen, maar mogen de stappen niet dupliceren. Een productpagina kan linken van een mogelijkheid naar de installatie. Een ultieme gids kan linken van een brede fase naar de relevante procedure. Een probleemoplossingsartikel kan teruglinken naar de beginsituatie van de gids nadat het symptoom is opgelost.
Dupliceer geen “hoe te kiezen”-beslissingsgids, een symptoomgestuurd probleemoplossingstraject of algemene documentatie. Als een zusterpagina meer dan een korte samenvatting van dezelfde reeks nodig heeft, stel dan één canonieke procedure vast en link ernaar. Houd versiespecifieke variaties op één pagina wanneer de hoofdroute gedeeld wordt; splits ze alleen wanneer de stappen of vereisten wezenlijk uiteenlopen.
Hoe resultaten te meten
Meten volgt de belofte van de gids: is de procedure gevonden voor de beoogde taak, geselecteerd als een nuttige bron, gevolgd en verbonden met een betekenisvolle volgende status? Gebruik AI-rank tracking om terugkerende doelgerichte prompts te monitoren, inspecteer vervolgens Prompt Tracking voor de antwoordbewoording, geciteerde URL, engine en concurrentenbronnen. De werkende directe link is open Prompt Tracking .
Noteer de prompts en een basislijn van vóór publicatie. Volg citaten apart van merkvermeldingen. Gebruik op de site voltooiingsbewijs zoals het bereiken van de eindcontrole, het selecteren van de volgende-stap-CTA, het voltooien van een bijbehorende productgebeurtenis of verminderde ondersteuningsvraag. Elk is bewijs, geen bewijs; scroll-diepte kan niet aantonen dat de procedure heeft gewerkt.
FAQ
Veelgestelde vragen
Wat maakt een how-to-gids anders dan documentatie?
Heeft elke stap een screenshot nodig?
Hoeveel stappen moet een how-to-gids hebben?
Moet een how-to-gids HowTo-schema bevatten?
Waar moet probleemoplossing verschijnen?
Hoe moet een team een how-to-gids meten?
Zet de gids in productie
Test de procedure met een representatieve lezer en gebruik vervolgens het CTA-blok om één actie aan te bieden die logisch voortvloeit uit geverifieerde voltooiing.
Meer tutorials in deze sectie
Klaar om het in de praktijk te brengen?
Gratis check · 7 dagen proefperiode · geen creditcard nodig