Preskoči na vsebino

Prispevovanje k cMind 🛠️

Hvala, ker si tu. cMind postane bolje vsakič, ko nekdo odpre问題, prijavi natančno cTrader vedenje, popravi pisemo v teh dokumentih ali pošlje PR. Ne rabiš biti .NET čarovnik — testeri, trgovci in popravci dokumentov so enako vredni kot ljudje, ki pišejo agregatoje.

Kanonični vodnik živi v repozitoriju

Ta stran je prijazna pot vstopa. Polni, vedno aktualni proces — osnovna pravila, dogovori o kodiranju, tok pregleda — je v CONTRIBUTING.md.

Tvoje prvo prispevanje v ~10 minutah​

git clone https://github.com/amusleh-spotware-com/cmind.git
cd cmind
dotnet restore
dotnet build          # 0 opozoril, ali bo CI ljubo odklonila
dotnet test           # enote + integracija + E2E

Našel si kaj za popravilo? Grani ga, spremeni, dodaj test in odpri PR. To je celoten cikel.

Načini pomoči (ne vsi so koda)​

PrispevekNaporKjer
🐛 Prijavi reproducibilen hrošč10 minPoročilo o hrošču
💡 Predlagaj funkcionalnost10 minZahteva za funkcionalnost
📖 Izboljšaj te dokumente15 minUredi pod website/docs/ in PR
🧪 Dodaj manjkajoči test30 mintests/UnitTests · IntegrationTests · E2ETests
🧠 Prijavi točno cTrader vedenje10 minOdpri razpravo

Hiške pravila (kratka verzija)​

cMind premika pravi denar, zato je nekaj stvari nenegotljivo — in pošteno, to spravi kodo v radost za delo:

  • Stroga Domain-Driven Design. Poslovna logika živi na agregatojih in vrednostnih objektih, nikoli v končnih točkah ali UI. (V repozitoriju je prijazna igračka zanj.)
  • Tri stopnje testiranja, vsaka sprememba. Enota + integracija + E2E, vključno poti napak (padli spojčni, zavrnjeni orders, mrtvi vozlisčni). Zeleni testi so cena vstopa.
  • Nič opozoril. TreatWarningsAsErrors=true. Moderni C# 14 idiomi.
  • Brez skrivnosti, brez magičnih nizov, nikoli DateTime.UtcNow (injiciraj TimeProvider namesto).
  • Docs v istega commit. Spremeni vedenje → posodobi dokumentacijo. Da, to vključuje to spletno mesto.

Polni podrobnosti, s zakaj za vsakim pravilom, v CONTRIBUTING.md in AGENTS.md.

Prispevovanje z AI 🤖​

Resnično pozdravljamo AI-asistentove PR — ta projekt je zgrajen za delo agentov kot tudi ljudi. Če vozi Claude, Copilot ali podobno: usmeritiv AGENTS.md, da prebere ugneždene CLAUDE.md datoteke in ga držiSameľudskihmeri (testi, nič opozoril, DDD). Dobra AI PR je nerazločljiva od dobre človeške PR — enaka pregled, enaka pozdravljanja.

Budi izvrstna drug do drugega​

Imamo Kodeks vedenja. Bistvo: budi ljubezniv, predpostavi dobro vest in ne pozabi da je oseba (ali agentinja osebe) na drugem koncu. Sprašuj kmalu — to je moč, ne neprijetnost.

Dobrodošel. Ne moremo se dočakati kaj boš zgradil. 🎉