Aquests apunts resumeixen els passos rellevants a seguir per promocionar el teu projecte de codi obert de forma òptima. Pots clicar els elements per expandir i obtenir més informació d'un tema.
Llista d'idiomes disponibles:
- العربية
- English
- Català
- Deutsch
- Español
- پارسی
- Français
- Bahasa Indonesia
- Italiano
- 日本語
- Português
- Русский
- සිංහල
- Türkçe
- 简体中文
- 繁體中文
Falta algun idioma? Desitges millorar aquesta guia? Les aportacions són benvingudes!
👌 Assegura't que el teu projecte sigui suficientment madur
El teu projecte ha de ser suficientment estable amb un mínim de funcionalitats viables per tal d'atreure usuaris.
😎 Escull un nom atractiu pel teu projecte
Escull un nom que els usuaris puguin recordar fàcilment.
💅 Fes elegant el teu README
El README és lo primer que veuran els teus visitants. Fes-lo simple, elegant i fàcil de llegir. Aquí hi ha una llista de READMEs bonics.
💪 Destaca els punts forts del teu projecte
Identifica les fortaleses del teu projecte i assegura't que els visitants les vegin primer.
✨ Proporciona una demostració del teu projecte
Els visitants voldran entendre ràpidament el propòsit del teu projecte, com funciona i com utilitzar-lo. Proporcionant una demostració és la millor manera de satisfer els usuaris. Pofria ser:
- Un GIF animat demostrant com funciona el teu projecte
- Un enllaç a una demostració en viu
👌 L'instal·lació/Ús ha de ser súper fàcil
Probablement perdràs visitants si el teu projecte no és fàcil d'utilitzar.
📘 Crea una documentació neta i ben estructurada
Crear una bona documentació és probablement el pas més important. Si tens poca documentació, la pots incloure al README. En cas contrari, probablement hauries d'allotjar-la a un lloc web separat. Alguns projectes de codi obert com vuepress poden ajudar-te a crear documentació neta d'una forma senzilla.
⭐ Fes que el teu projecte sigui confiable abans no el publiquis a les xarxes socials
La majoria dels visitants comprovaran quantes estrelles té el teu projecte abans no considerin utilitzar-lo. Un mínim d'estrelles fa més confiable el teu projecte que un altre amb zero estrelles. Per això hauries de demanar a la gent que coneixes que recolzin el teu projecte abans d'anunciar-lo públicament a les xarxes socials.
↗️ Comparteix el teu projecte a les xarxes socials i plataformes especialitzades
Explica al món el teu fantàstic treball! Publica a les xarxes socials i plataformes especialitzades:
📃 Escriu articles fent menció al teu projecte
Escriu articles sobre el teu projecte. El propòsit pot ser el conjunt de tecnologies utilitzades, com funciona el teu projecte, problemes que t'hagis trobat, etc. Publica a plataformes com:
🎤 Presenta el teu projecte a conferències/reunions
Presentar el teu projecte a conferències o reunions és una bona forma de millorar la seva visibilitat.
🎥 Grava i publica vídeos sobre el teu projecte, com funciona, etc.
Gravar un vídeo no és una tasca fàcil. Però probablement sigui la forma més més eficient de fer famós el teu projecte.
🕐 Escull el millor moment per publicar a les xarxes socials
No publiquis durant les vacances o els caps de setmana. Normalment el millor moment per publicar a les xarxes socials és entre setmana.
🗑 No facis spam a les plataformes amb la teva promoció
No publiquis dues vegades a la mateixa plataforma. Pot ser considerat spam i pot causar mala publicitat al teu projecte.
🆕 Procura publicar periòdicament noves versions del teu projecte
Mantingues i millora el teu projecte amb noves versions i genera registres de canvi.
❗ Mantingues el teu projecte, processa els casos oberts
No deixis casos obertes pendents de resposta. Sigues educat amb la gent que s'ha pres la molèstia d'obrir un cas. 😉
🙏 Convida els usuaris a contribuir
Un projecte saludable és un projecte amb una comunitat i contribuïdors. Informa els usuaris que necessites ajuda etiquetant alguns casos amb
contribution welcome
ogood first issue
. Veure etiquetes de github.
🏆 Recompensa els col·laboradors
Sigues amable amb la gent que t'ha ajudat! Alguns projectes de codi obert com gatsby recompensen als col·laboradors amb utilitats. Si no t'ho pots permetre, publica (a twitter o altres plataformes) sobre la col·laboració i menciona l'aturo (aquí hi ha un exemple d'agraïment públic). Obre una secció de
Col·laboradors
al teu arxiu README per donar-los les gràcies públicament o mostra'ls a la teva documentació o lloc web. Aquí n'hi ha alguns exemples:
💬 Obre una plataforma de xat de comunitat
Els casos pendents de Github no són sempre el millor lloc on comunicar-se amb els teus usuaris. Si és necessari, pots utilitzar plataformes de xat per discutir amb ells:
🔙 Demana retroalimentació
La informació proporcionada pels usuaris és la més útil per millorar el teu projecte. Ells possiblement tinguin funcionalitats i idees que poden millorar el teu projecte.
❤️ Obre una galeria de casos d'ús per mostrar què han construït els usuaris amb el teu projecte
Els visitants confiaran amb el teu projecte si veuen casos d'ús concrets i històries d'èxit, p.ex., la galeria vuepress.
⭐️ a aquest repositori si aquests apunts t'han ajudat!
Gràcies a aquestes meravelloses persones:
Aquest projecte segueix l'especificació all-contributors. Les contribucions de qualsevol mena són benvingudes!