In questi appunti sono riassunti alcuni passaggi importanti da seguire per poter promuovere efficacemente il vostro progetto open source. Potete cliccare un elemento per espandere l'argomento ed avere più informazioni.
Lista delle lingue disponibili:
- العربية
- English
- Català
- Deutsch
- Español
- پارسی
- Français
- Bahasa Indonesia
- Italiano
- 日本語
- Português
- Русский
- සිංහල
- Türkçe
- 简体中文
- 繁體中文
Non trovi la tua lingua? Vuoi migliorare questi appunti? I vostri contributi sono sempre benvenute!
Una versione in PDF di questi appunti è presente qui
👌 Assicurati che il progetto sia abbastanza maturo
Il tuo progetto deve essere abbastanza stabile e con un set minimo di feature per poter catturare l'attenzione dei visitatori.
😎 Scegli un bel nome per il tuo progetto
Scegli un nome che si possa ricordare facilmente.
💅 Crea un README accattivante
Il README è la prima cosa che i visitatori vedranno. Fallo semplice, accattivante e facile da leggere. Qui una lista di README ben fatti.
💪 Sottolinea i punti forti del tuo progetto
Identifica i punti forti e fai in modo che siano tra le prime cose che gli utenti vedranno.
✨ Metti a disposizione una demo del tuo progetto
I visitatori vorranno velocemente capire lo scopo del tuo progetto, come funziona e come usarlo. Preparare una demo è il modo più efficace per soddisfarli. Potrebbe essere:
- Una GIF animata che mostra come funziona;
- Un link ad una demo interattiva.
👌 L'installazione e l'utilizzo devono essere semplici
Probabilmente perderai utenti se il tuo progetto non è user-friendly.
📘 Crea una documentazione pulita e ben strutturata
Creare una buona documentazione è probabilmente la fase più importante. Se hai poco da documentare, puoi includerlo tutto nel tuo README. Altrimenti, probabilmente dovresti creare un sito web dedicato. Alcuni progetti open source come vuepress possono aiutarti nel creare una documentazione pulita in maniera semplice.
⭐ Fa si che il progetto sembri affidabile prima di publicarlo sui social networks
Molti utenti controlleranno quante stelle ha il progetto prima di considerare se usarlo. Un minimo numero di stelle fa sembra il tuo progetto più affidabile di uno con zero. Dovresti provare a chiedere alle persone che conosci di aiutarti supportando il tuo progetto prima di fare un annuncio publico sui social media.
↗️ Condividi il progetto sui social media ed altre piattaforme specializzate
Racconta al mondo il tuo fantastico progetto! Publica sui social media e piattaforme specializzate:
📃 Scrivi degli articoli dove menzioni il tuo progetto
Scrivi degli articoli sul tuo progetto. Puoi parlare della stack tecnologica utilizzata, come funziona, i problemi che hai incontrato e risolto, etc. Publicalo su piattaforme specializzate:
🎤 Presenta il tuo progetto ad una conferenza o un meetup
Presentare il tuo progetto ad una conferenza o un meetup è un buon modo per aumentarne la visibilità.
🎥 Registra e publica video dove presenti il tuo progetto, come funziona, etc
Registrare un video non è un esercizio semplice, ma è probabilmente la maniera più efficace per rendere il tuo progetto famoso.
🕐 Scegli il miglior orario per publicare sui social media
Non publicare durante le feste o i fine settimana. Di solito il miglior orario per publicare è in mezzo alla settimana.
🗑 Non fare spam sulle piattaforme
Non publicare due volte (o più) sulla stessa piattaforma. Verrà considerato come spam e potrebbe generare pessima reputazione per il tuo progetto.
🆕 Cerca di rilasciare regolarmente nuove versioni del tuo progetto
Mantieni e migliora il tuo progetto con nuove release e genera dei changelog.
❗ Mantieni il progetto, gestisci gli issue aperti
Non lasciare issue aperti senza una risposta. Sii gentile cone le persone che hanno speso il loro tempo per aprirti un issue. 😉
🙏 Invita gli utenti a contribuire
Un buon progetto è uno che ha una comunità e dei collaboratori. Fai sapere ai tuoi utenti che ti serve aiuto taggando alcuni issue con le label
contribution welcomeogood first issue. Leggi di più sulle Label.
🏆 Premia i collaboratori
Sii gentile con le persone che ti hanno aiutato! Alcuni progetti open source come gatsby premiano i collaboratori con dei gadget. Se non puoi permetterlo, fai un post publico (su twitter o altre piattaforme) il contributo dato e menzionando l'autore (qui un esempio di ringraziamento publico). Crea una sezione
Contributorsnel tuo README per ringraziare publicamente e mostrare gli autori nella tua documentazione o sito web. Di seguito alcuni esempi:
💬 Crea una comunità su una piattaforma di messagistica
Gli issue di github non sono spesso la maniera migliore per comunicare con i tuoi utenti. Se necessario utilizza altre piattaforme per discutere con loro, ad esempio:
🔙 Chiedi un feedback
I feedback degli utenti sono la maniera migliore per migliorare il progetto. Probabilmetne hanno idee che renderanno migliore il tuo progetto.
❤️ Apri una galleria con gli use-case per mostrare cosa gli utenti hanno costruito usando il tuo progetto
I visitatori crederanno di più al tuo progetto se vedranno degli use-case concreti e delle storie di successo, come ad esempio, the vuepress gallery.
Metti una ⭐️ se questo repository ti è stato di aiuto!
Un grazie va a queste persone meravigliose:
Questo progetto segue la specifica all-contributors. Contributi di ogni genere sono sempre benvenuti!