Per què un document de FAQs?

Una LAN Party reuneix persones amb diversos nivells tècnics. Això provoca preguntes repetitives que si no estan documentades cauen sobre les mateixes persones.

Un document de FAQs ben estructurat ajuda a evitar repetir respostes, permet als participants resoldre els seus dubtes i prevé errors comuns com connectar a la xarxa amb IP manual.

La diferència entre una FAQ ben feta i una llista de preguntes tirada d’un doc de Google és la categorització, la claredat de les respostes i que la informació estigui actualitzada. Una FAQ desactualitzada o incompleta és pitjor que no tenir-ne cap.

Convertir el document a JSON fa que la informació sigui reutilitzable. Es pot integrar en una app web, un bot o altres sistemes.

Document de FAQ’s en format text

Les FAQs estan organitzades per facilitar-ne la navegació. Cada resposta inclou els passos necessaris o la informació concreta, sense envoltoris.

Conversió de les FAQ’s a JSON

Un cop tenim el document de FAQs en text, la conversió a JSON segueix una estructura que permet escalar la base de dades fàcilment. L’estructura tria un esquema de categories com a objectes pare, amb cada FAQ com a element d’un array.

Per a poder transformar aquest PDF a un JSON li he dit a la IA que converteixi l’arxiu PDF a un JSON.

Un cop ja transformat a un fitxer JSON ho he passat a una carpeta al Drive.

Aquestes són les 5 primeres preguntes en format JSON