Skip to content

Latest commit

 

History

History
46 lines (28 loc) · 3.26 KB

CONTRIBUTING.md

File metadata and controls

46 lines (28 loc) · 3.26 KB

Contribuind la Nexus Community Toolkit

Suntem încântați că iei în considerare să contribui la repozitoriul Nexus Community Toolkit! Acest document conturează standardele și liniile directoare pe care trebuie să le urmezi când adaugi sau modifici conținut. Te rugăm să-l citești cu atenție înainte de a face orice trimiteri.

Indicatii generale

1. Cod Bine Documentat:

  • Comentarii: Asigură-te că codul tău are comentarii clare. Comentariile ar trebui să explice ce face codul, nu cum. Dacă codul este complex, explică logica din spatele acestuia.
  • Nume de Variabile: Folosește nume de variabile care indică clar scopul variabilei. De exemplu, totalFactura este mai semnificativ decât tf.

2. Tutoriale:

  • Structură: Asigură-te că tutorialele au o structură clară. Începe cu o introducere, apoi conținutul principal și termină cu o concluzie sau rezumat.
  • Explicație: Alături de pași sau fragmente de cod, oferă explicații sau motivații pentru abordarea dată.
  • Imagini: Folosește imagini sau capturi de ecran acolo unde este necesar, dar asigură-te că sunt de bună calitate și îmbogățesc tutorialul în loc să distragă.

3. Motivații:

  • De ce Această Abordare: De fiecare dată când propui o tehnică sau soluție, oferă raționamente pentru care această abordare particulară este benefică sau de ce o preferi față de alte alternative.

4. Lizibilitate:

  • Asigură-te că folosești un format adecvat pentru conținutul tău. Acest lucru include utilizarea de titluri, liste, blocuri de cod și alte unelte de formatare adecvat.

5. Testare:

  • Asigură-te că orice cod sau soluție trimisă este testată și funcționează conform așteptărilor. Indică clar mediul, versiunea sau orice alte condiții specifice în care codul a fost testat.

6. Respect și Amabilitate:

  • Amintește-ți să abordezi contribuțiile cu respect. Critica constructivă este întotdeauna binevenită, dar evită comentariile negative sau defăimătoare.

Procesul de Trimitere

  1. Fork la Repozitoriu: Dacă ești nou în acest domeniu, verifică ghidul GitHub despre cum să faci un fork la repozitory.

  2. Clonează Fork-ul Tău: Clonează-l pe computerul tău local pentru a face schimbările.

  3. Fă Schimbările Tale: Adaugă resursele, tutorialele sau codul tău. Asigură-te că urmezi liniile directoare menționate mai sus.

  4. Trimite la Fork-ul Tău: Trimite schimbările la fork-ul tău pe GitHub.

  5. Trimite o Solicitare de Pull Request (PR): Din fork-ul tău, deschide o solicitare de pull către repozitoriul principal. Asigură-te că PR-ul tău urmează șablonul PR și oferă toate informațiile necesare.

  6. Revizuire PR: Administratorii vor revizui PR-ul tău. Ei ar putea sugera schimbări, îmbunătățiri sau solicita informații suplimentare dacă este necesar.

  7. Îmbinare: Odată aprobat, PR-ul tău va fi combinat în repozitoriul principal.

Note Finale

Îți mulțumim că iei în considerare să contribui la Nexus Community Toolkit. Efortul și expertiza ta ajută la îmbogățirea comunității și o fac o resursă valoroasă pentru toată lumea!