Сваки производ или услуга пре или касније добије иста питања купаца. Добра документација на сајту одговара на њих уместо вас, у било које доба дана, а Google и AI асистенти је читају и упућују људе на ваш сајт. За то не треба посебан систем ни претплата. WordPress који већ имате је довољан, ако документацију организујете како треба.
Као пример користимо документацију на овом сајту, направљену управо на начин описан у наставку.
Шта чини добру документацију
- Одвојена је од блога. Упутство није вест и не треба да се губи међу чланцима по датуму.
- Има јасан ред. Читалац види где је и шта следи: прво инсталација, па подешавања, па решавање проблема.
- Лако се претражује, и то само кроз документацију, без резултата са блога и из продавнице.
- Адресе су кратке и стабилне, јер на њих упућујете из мејлова, тикета и са других страна.
- Увек је ажурна. Читалац треба да види за коју верзију важи и када је последњи пут допуњена.
Корак 1: Посебан тип садржаја
Направите тип садржаја „Документација“. Тако документација добија свој мени у администрацији, своју листу и своју архиву на сајту, на пример /dokumentacija/. Зашто је то боље од чланака са категоријом, објаснили смо у чланку о томе шта је custom post type.
При прављењу типа обратите пажњу на три подешавања:
- Хијерархијски и део уређивача „Редослед и надређени“, ако желите поглавља са потпоглављима.
- Архива укључена, са адресом коју ћете дуго користити.
- Кључ и адреса латиницом, малим словима и без квачица. Кључ касније не мењајте.
Корак 2: Области уместо категорија блога
Направите таксономију само за документацију, на пример „Област“, и у њу неколико широких области. На овом сајту то су Плаћање и продавница, Ћирилица и латиница, Садржај и структура сајта и Брзина и изглед сајта.
- Мало области, широке. Област са једним документом изгледа празно.
- Не правите поткатегорију са истим именом као документ. Ако је документ „Подешавање плаћања“, поткатегорија „Подешавање плаћања“ је само дупликат.
- Тагове оставите за касније, када буде довољно текстова да се исти таг понови на више места.
Ако имате више производа, област можете ставити и у адресу: /dokumentacija/placanje/podesavanje-banke/. Одлучите то на почетку, јер касна промена мења све адресе.
Корак 3: Један дугачак документ или више кратких
Оба приступа су добра, а избор зависи од производа:
- Један документ по производу, са садржајем на врху и поглављима испод. Лако се штампа, претражује са Ctrl+F и чита у једном даху. Тако је урађена документација на овом сајту.
- Више кратких страна, по једна за свако поглавље, повезане претходном и следећом страном. Боље је када производ има много тема или када желите да свака тема има свој резултат у претрази.
Код дугачког документа обавезно направите садржај са линковима на поглавља и дајте сваком поглављу сталну котву, на пример #cesta-pitanja, да бисте у тикетима могли да пошаљете линк тачно на одговор.
Корак 4: Редослед који ви одређујете
Блог иде од најновијег, а документација мора да иде логичним редом: „Почетак“ пре „Напредних подешавања“, без обзира на то шта је написано прво. Укључите сопствени редослед и сложите записе превлачењем у листи. Најважнији документ можете истаћи на врх архиве, као закачен пост на блогу.
Корак 5: Навигација
Читалац у документацији не сме да се изгуби. Три ствари то решавају:
- Путања изнад наслова: Почетна › Документација › Плаћање › Подешавање банке.
- Бочни мени са свим документима груписаним по области и означеним документом који се чита.
- Претходна и следећа страна на дну, у истој области, ако документацију делите на више страна.
Корак 6: Претрага само кроз документацију
Обична WordPress претрага тражи по целом сајту, па на питање „повраћај новца“ врати и чланке са блога и производе. У бочну траку документације ставите претрагу која тражи само у типу „Документација“. Резултати су тада кратки и тачни.
Корак 7: Картице у архиви
- Упишите извод у сваки документ, једну или две реченице о томе шта покрива. Аутоматски извод често ухвати почетак стране, а то није добар опис.
- Уместо датума објаве прикажите датум последње измене, или верзију за коју документ важи.
- Време читања за документацију нема смисла, па га искључите.
Корак 8: Да вас нађу Google и AI асистенти
- наслови поглавља нека буду питања или радње које људи траже: „Како да вратим новац купцу“, а не „Повраћај“;
- део „Честа питања“ на крају сваког документа, са кратким и директним одговорима;
- тачни подаци у тексту, а не на сликама, јер текст са слике ни претраживач ни асистент не читају поуздано;
- на почетку документа верзија и датум, да читалац и претраживач знају да је упутство свеже.
Са додатком NikolicWP CPT
Све кораке из овог чланка покрива један додатак, NikolicWP CPT (Custom Post Type):
- тип садржаја и таксономија са свим опцијама, уз преглед уживо и натписе на српском;
- таксономија у адреси, ако вам треба;
- сопствени редослед превлачењем, „На врх“ и „На дно“ и истицање на врху архиве;
- блокови и кратки кодови за путању (
), бочни мени (), претрагу у једном типу (), претходну и следећу страну () и листу записа (- Како да WordPress сајт буде на ћирилици и латиници – без дуплирања садржаја
- Како да направите документацију или базу знања у WordPress-у
Како да на свом WordPress сајту направите уредну документацију или базу знања: тип садржаја, области, редослед, бочни мени и претрага, без посебних алата.
- Како да подесите цену доставе по курирској служби и тежини пакета
- Како да пријавите латиничну верзију сајта у Google Search Console
- Како да примате плаћање картицом у WooCommerce продавници у Србији
- Шта је custom post type и када вам треба више од чланака и страница
- прилагођена поља, на пример „Верзија“ и „Ниво“, која се могу приказати аутоматски уз сваки документ.
Пример подешавања баш за документацију налази се у документацији додатка, у поглављу „Пример: документација производа“.
Честа питања
Зашто не користити обичне странице за документацију?
Можете, ако имате пет страна које се ретко мењају. Са више страна странице се мешају са Контактом и правним странама, немају архиву, области ни претрагу само кроз документацију.
Треба ли документацији бочна трака?
На архиви и код кратких страна да: претрага и мени са свим документима. Код дугачког документа са сопственим садржајем бочна трака није неопходна, а цела ширина олакшава читање табела.
Може ли документација да буде само за купце?
Може, али онда је Google не види и не доводи вам нове купце. Боље је да основно упутство буде јавно, а да само посебни водичи буду иза пријаве.
Шта ако промените тему?
Ако је тип садржаја направљен додатком, а не у теми, документација остаје где јесте, са истим адресама. Мења се само изглед.
Укратко: посебан тип садржаја, неколико широких области, редослед који ви одређујете, бочни мени и претрага само кроз документацију. Тако купци сами налазе одговоре, а ви на питања одговарате линком уместо дугачким мејлом.
