Crear un document de FAQs habituals en una LAN Party

1. Justificació i Experiència d’Usuari (UX)

La disponibilitat d’un document de FAQ’s és un pilar fonamental per a l’èxit d’una LAN Party. Des de la perspectiva de l’Experiència d’Usuari (UX), aquest recurs redueix l’ansietat tècnica i permet una preparació prèvia més eficaç. Hem analitzat els punts crítics de connectivitat i logística per garantir que qualsevol usuari pugui resoldre dubtes de manera autònoma.

2. Preguntes Freqüents (FAQs)

🌐 Xarxa i Connectivitat

P: Quina velocitat de xarxa tindrem?
R: Tindrem 1Gbps simètric disponible per a tots els participants.

P: Cal portar cable de xarxa propi?
R: Sí, és obligatori portar un cable CAT6 d’almenys 5 metres.

⚡ Energia i Hardware

P: Quants endolls tindré disponibles?
R: Cada participant té accés a una única presa de corrent. Es recomana portar una regleta.

P: Quins són els requisits mínims del PC?
R: Qualsevol equip capaç d’executar els jocs del torneig. Recomanem 16GB de RAM.

3. Conversió a Format JSON

Estructura de dades escalable, validada i organitzada per categories:

{
  "lan_party_faqs": [
    {
      "id": 1,
      "categoria": "Xarxa",
      "pregunta": "Velocitat?",
      "resposta": "1Gbps simètric."
    }
  ]
}
        

4. Equip de Treball

  • Nom i Cognom: Iman Noor
  • Nom i Cognom: Sergi Villanueva
  • Nom i Cognom: Miquel Martin

Veure Repositori a GitHub

Evidències del Projecte

Documentació detallada de la creació pas a pas.

📸 Pas 1: Configuració del Repositori

Com ho vam fer: Vam iniciar sessió a GitHub i vam crear un nou repositori anomenat LAN-Party-FAQ-Project. El vam configurar com a Públic i vam marcar l’opció d’afegir un fitxer README.md. Aquest és el primer pas per tenir un espai de treball compartit amb l’equip.

📸 Pas 2: Disseny de la Pàgina Directori

Com ho vam fer: Vam utilitzar el llenguatge Markdown per escriure el README. Vam utilitzar etiquetes com # per als títols i ** per a les negretes. L’objectiu era crear una guia clara que expliqués de què tracta el projecte i qui som els integrants de l’equip.

📸 Pas 3: Pluja d’Idees i UX

Com ho vam fer: Ens vam reunir per pensar com usuaris. Vam analitzar quins problemes tindria algú en arribar a la LAN Party. Vam decidir separar les preguntes en categories (Xarxa, Hardware i Energia) per fer que la informació fos fàcil de trobar i millorar l’experiència d’usuari (UX).

📸 Pas 4: Arquitectura de Dades JSON

Com ho vam fer: A GitHub, vam crear un fitxer nou anomenat faqs.json. En lloc d’escriure text normal, vam utilitzar claus (keys) com “pregunta” i “resposta” entre cometes. Això permet que les dades estiguin “netes” i preparades perquè un ordinador les pugui llegir automàticament.

📸 Pas 5: Organització del Codi

Com ho vam fer: Vam assignar un ID únic a cada pregunta (1, 2, 3…). Això fa que el projecte sigui “escalable”, és a dir, si demà volem afegir 100 preguntes més, el sistema seguirà funcionant perfectament gràcies a aquesta organització tècnica.

📸 Pas 6: Validació Tècnica i Revisió de Sintaxi

Com ho vam fer: Per garantir que les nostres dades fossin 100% funcionals, vam utilitzar una eina de validació externa anomenada JSONLint.

La validació és un pas crític: qualsevol error mínim pot fer que tota una aplicació deixi de funcionar. Vam analitzar l’estructura a la recerca d’errors i, un cop l’eina va confirmar el format correcte, vam saber que la nostra base de dades estava llista.

📸 Pas 7: Publicació del Treball

Com ho vam fer: Vam clicar a “Commit changes” per guardar la versió final. Vam afegir un missatge de descripció per deixar clar què havíem fet. Amb aquest pas, el fitxer ja està disponible al servidor de GitHub de forma permanent.

Take the next step to success

Many Web3 platforms are complex and have a steep learning curve, discouraging new users from entering the space.