Skip to content

Latest commit

 

History

History
332 lines (246 loc) · 19.5 KB

README-ca.md

File metadata and controls

332 lines (246 loc) · 19.5 KB

oss image

tweet

Apunts per la promoció del codi obert

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:

Falta algun idioma? Desitges millorar aquesta guia? Les aportacions són benvingudes!

1. 🎢 Passos de preparació


👌 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.


2. 📢 Fes córrer la veu sobre la teva tasca


⭐ 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.


3. 🤝 Mantingues els teus usuaris


🆕 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 o good 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.


🙏 Mostra el teu suport

⭐️ a aquest repositori si aquests apunts t'han ajudat!


❤️ Contribuïdors

Gràcies a aquestes meravelloses persones:


Franck Abgrall

📖

Thomas Betous

📖

Eric Briand

📖

Faustine Godbillot

📖

Benjamin Plouzennec

📖

Johan Bonneau

📖

Benjamin Petetot

📖

NickHatBoecker

🌍

Claire Martinez

🌍

André Gama

📖

Mathias Bernardeau

📖

Antoine Oili

📖

Oswld TC

🌍

Zhiyue Yi

🌍

Ali khalili

🌍

Niusha Pakseresht

🌍

David Da Silva

🌍

Umut Işık

🌍

Alex Castells

🌍

Koji

🌍

pasindu p konghawaththa

🌍

Marcel

📖

Ikko Ashimine

📖

Nicolas Lepage

🚧

Sergey Scat

🌍

Mohammed Taha

🌍

T. JEGHAM

👀

Tarek Touati

👀

Simone Corsi

🌍

Anicet Togue

👀

Krzysztof Juszcze

📖

Hanz

🌍

Rafli Surya P

📖

Kurt

📖

JumperBot_

📖

Aquest projecte segueix l'especificació all-contributors. Les contribucions de qualsevol mena són benvingudes!