turbolabit / turbolab.it Goto Github PK

Questo repository (link breve: https://turbolab.it/codice ) contiene il codice sorgente del sito TurboLab.it.

TurboLab.it (TLI) è una community online, fondata nel 2013, con lo scopo di divenire un polo di aggregazione per smanettoni, professionisti e appassionati di computer e informatica che amino scrivere articoli tecnici, manuali, guide e/o confrontarsi con altri utenti che condividano la stessa passione. Il progetto è no-profit.

Le due macro-aree sono:

• area editoriale: inserimento e visualizzazione di articoli (guide, news, ...)
• commmunity: forum di discussione

La peculiarità del sito è che chiunque può inserire articoli (basta essere registrati) e modificarli in seguito. Gli utenti con autorevolezza elevata (ovvero: moderatori del forum e altri utenti che inseriscano articoli periodicamente) decidono se e quando pubblicare gli articoli inseriti, cioè farli comparire in home page e sui canali social ufficiali.

📃 Manifesto: TurboLab.it: chi siamo e cosa facciamo

Se vuoi partecipare a TurboLab.it come autore o moderatore, fai riferimento a questo articolo:

📃 Come partecipare a TurboLab.it

Se invece vuoi contribuire al codice sorgente disponibile in questo repository come programmatore o grafico: il codice è attualmente in fase di startup, e non accettiamo (ancora) contributi esterni. Questo cambierà nel prossimo futuro: le modalità per contribuire verranno pubblicate su queste pagine non appena avremo completato la fase iniziale di avvio.

Se invece vuoi segnalare un problema con il sito, segui questa procedura:

📃 Ho un'idea / suggerimento / problema con TurboLab.it: cosa faccio?

1. 🔥 Il codice deve essere facile da mantenere - non ci interessa che "non ci siano errori". Ci interessa che sia sempre FACILE CORREGGERLI ed aggiungere nuove funzionalità in modo facile e piacevole, senza forzature o riscritture
2. ✍️ Agevolare il lavoro agli autori - adottiamo ogni accortezza, idea e scorciatoria permetta di inserire articoli in modo efficiente, comodo e piacevole. Ricordiamo che, per rendere accessibile l'editor a tutti ed impedire agli autori di impiegare layout "fantasiosi", l'editor consente di usare solo h1, p, e pochi altri tag
3. 🔎 Ottimizzare la SEO - l'87.85% del traffico arriva dai motori di ricerca
4. 🤖 Automatizzare al massimo - abbiamo tutti poco tempo da dedicare al progetto, quindi tutto quello che può essere automatizzato deve esserlo
5. 👓 Garantire una buona leggibilità - gli articoli sono mediamente lunghi o molto-lunghi. Usiamo font grandi, alto contrasto, spaziature efficaci per renderli piacevoli da leggere
6. 🤓 Affinare la nostra professionalità come sviluppatori, designer, progettisti software

Al contrario di WordPress, l'inserimento articoli avviene direttamente sulla pagina dell'articolo stesso. Concettualmente, vogliamo ridurre al minimo le "aree riservate" e, idealmente, non avere nemmeno un'"area admin": vogliamo rendere pubblico tutto quello che può esserlo senza compromettere la sicurezza o i dati personali degli utenti.

La documentazione a supporto del codice sorgente è disponibile qui:

📚 DOCUMENTAZIONE/wiki

Per tutte le domande e il coordinamento dello sviluppo, usiamo il forum:

💬 Forum

No, non abbiamo e non vogliamo usare né Slack, né una chat su Telegram o qualsiasi altro strumento di conversazione sincrona. Il forum pubblico è il nostro strumento di comunicazione.