Skip to content

Latest commit

 

History

History
141 lines (92 loc) · 6.86 KB

CONTRIBUTING.md

File metadata and controls

141 lines (92 loc) · 6.86 KB

Contribuir a Roo Code

Roo Code és un projecte impulsat per la comunitat i valorem profundament cada contribució. Per agilitzar la col·laboració, operem sobre una base de primer la incidència, la qual cosa significa que totes les sol·licituds d'extracció (PR) primer han d'estar enllaçades a una incidència de GitHub. Si us plau, reviseu aquesta guia amb atenció.

Taula de continguts

Abans de contribuir

1. Codi de Conducta

Tots els col·laboradors han de complir el nostre Codi de Conducta.

2. Full de ruta del projecte

El nostre full de ruta guia la direcció del projecte. Alineeu les vostres contribucions amb aquests objectius clau:

La fiabilitat primer

  • Assegureu-vos que l'edició de diferències i l'execució d'ordres siguin fiables de manera consistent.
  • Reduïu els punts de fricció que desincentiven l'ús habitual.
  • Garantiu un funcionament fluid en tots els llocs i plataformes.
  • Amplieu el suport robust per a una àmplia varietat de proveïdors i models d'IA.

Experiència d'usuari millorada

  • Agilitzeu la interfície d'usuari/experiència d'usuari per a més claredat i intuïtivitat.
  • Milloreu contínuament el flux de treball per satisfer les altes expectatives que els desenvolupadors tenen de les eines d'ús diari.

Liderant en rendiment d'agents

  • Establir punts de referència d'avaluació complets (evals) per mesurar la productivitat del món real.
  • Feu que sigui fàcil per a tothom executar i interpretar aquestes avaluacions.
  • Envieu millores que demostrin augments clars en les puntuacions d'avaluació.

Mencioneu l'alineació amb aquestes àrees a les vostres sol·licituds d'extracció.

3. Uniu-vos a la comunitat de Roo Code

  • Principal: Uniu-vos al nostre Discord i envieu un missatge directe a Hannes Rudolph (hrudolph).
  • Alternativa: Els col·laboradors experimentats poden participar directament a través de Projectes de GitHub.

Trobar i planificar la vostra contribució

Tipus de contribucions

  • Correccions d'errors: abordar problemes de codi.
  • Noves característiques: afegir funcionalitats.
  • Documentació: millorar les guies i la claredat.

Enfocament de primera incidència

Totes les contribucions comencen amb una incidència de GitHub utilitzant les nostres plantilles bàsiques.

  • Comproveu les incidències existents: cerqueu a Incidències de GitHub.
  • Creeu una incidència utilitzant:
    • Millores: plantilla "Sol·licitud de millora" (llenguatge senzill centrat en el benefici per a l'usuari).
    • Errors: plantilla "Informe d'error" (reproducció mínima + esperat vs real + versió).
  • Voleu treballar-hi? Comenteu "Reclamant" a la incidència i envieu un missatge directe a Hannes Rudolph (hrudolph) a Discord per ser assignat. L'assignació es confirmarà al fil.
  • Les sol·licituds d'extracció han d'enllaçar a la incidència. Les sol·licituds d'extracció no enllaçades es poden tancar.

Decidir en què treballar

Informar d'errors

  • Comproveu primer si hi ha informes existents.
  • Creeu un error nou utilitzant la plantilla "Informe d'error" amb:
    • Passos de reproducció clars i numerats
    • Resultat esperat vs real
    • Versió de Roo Code (obligatori); proveïdor/model d'API si és rellevant
  • Problemes de seguretat: informeu de manera privada a través d' avisos de seguretat.

Procés de desenvolupament i submissió

Configuració del desenvolupament

  1. Bifurcació i clonació:
git clone https://github.com/EL_TEU_NOM_USUARI/Roo-Code.git
  1. Instal·leu les dependències:
pnpm install
  1. Depuració: Obriu amb VS Code (F5).

Directrius per escriure codi

  • Una sol·licitud d'extracció centrada per característica o correcció.
  • Seguiu les millors pràctiques d'ESLint i TypeScript.
  • Escriviu confirmacions clares i descriptives que facin referència a incidències (p. ex., Soluciona #123).
  • Proporcioneu proves exhaustives (npm test).
  • Rebaseu a la branca main més recent abans de la submissió.

Enviament d'una sol·licitud d'extracció

  • Comenceu com a PR d'esborrany si busqueu comentaris primerencs.
  • Descriviu clarament els vostres canvis seguint la plantilla de sol·licitud d'extracció.
  • Enllaceu la incidència a la descripció/títol de la PR (p. ex., "Soluciona #123").
  • Proporcioneu captures de pantalla/vídeos per a canvis a la interfície d'usuari.
  • Indiqueu si calen actualitzacions de la documentació.

Política de sol·licitud d'extracció

  • Ha de fer referència a una incidència de GitHub assignada. Per ser assignat: comenteu "Reclamant" a la incidència i envieu un missatge directe a Hannes Rudolph (hrudolph) a Discord. L'assignació es confirmarà al fil.
  • Les sol·licituds d'extracció no enllaçades es poden tancar.
  • Les sol·licituds d'extracció han de passar les proves de CI, alinear-se amb el full de ruta i tenir una documentació clara.

Procés de revisió

  • Triatge diari: revisions ràpides per part dels mantenidors.
  • Revisió setmanal en profunditat: avaluació completa.
  • Itereu ràpidament en funció dels comentaris.

Legal

En contribuir, accepteu que les vostres contribucions es llicenciaran sota la llicència Apache 2.0, d'acord amb la llicència de Roo Code.