பங்களிப்பு

அமைவு

சரியான இடத்தில் ஒரு சிறிய மாற்றத்தைச் செய்து, pull request ஆக அனுப்பவும்.

தொடங்கும் முன்

முதலில் ஒரு issue திறக்கவும், அல்லது ஏற்கெனவே உள்ளதில் கருத்து எழுதவும். எதை ஏன் மாற்ற விரும்புகிறீர்கள் என்று சொல்லவும்.
பதிலுக்காகக் காத்திருக்கவும். அப்போது இணைக்கப்படாத ஒன்றை நீங்கள் உருவாக்க மாட்டீர்கள்.
HolyArrs-ஐ உருவாக்கி இயக்க அமைவு பக்கத்தை முடிக்கவும்.

கேள்விகளை Discord-இல் கேட்கவும். யோசனைகளை r/HolyArrs-இல் சொல்லவும். Issues என்பவை பிழைகளுக்கும் roadmap-க்கும் மட்டும்.

முதல் pull request-ஐ அனுப்பவும்

உங்கள் மாற்றம் எந்த module-க்குச் சொந்தம் என்று கண்டுபிடிக்கவும். Modules பக்கத்தில் உள்ள பெயர்கள் அடைவுப் பெயர்களுடன் பொருந்தும், அதனால் தவறான Discord அறிவிப்பு என்பது alerts-இல் செய்ய வேண்டிய மாற்றம்.
மாற்றத்தை app/backend/internal/<module>/, app/frontend/src/lib/<module>/ ஆகியவற்றில் செய்யவும். ஒரு திருத்தம் அல்லது ஒரு வசதி என்ற அளவில் வைக்கவும்.
முதலில் web app-ஐ, பிறகு நிரலை உருவாக்கி, மாற்றத்தை browser-இல் முயன்று பார்க்கவும். அமைவு பக்கத்தைப் பார்க்கவும்.
சோதனை பக்கத்தில் உள்ள சோதனைகளை இயக்கவும்.

எந்தத் தோல்வியும் தெரியக்கூடாது.
ஒரு பக்கத்தை மாற்றியிருந்தால், அதன் end-to-end project-ஐ இயக்கவும், எடுத்துக்காட்டாக npm --prefix app/frontend run e2e -- --project=movies.
Pull request-ஐத் திறக்கவும். Issue-ஐ இணைக்கவும், என்ன மாறியது, எப்படிச் சோதித்தீர்கள் என்று சொல்லவும், மாற்றத்துக்கான சோதனைகளைச் சேர்க்கவும் அல்லது புதுப்பிக்கவும்.
உங்கள் முதல் pull request-இல், பங்களிப்பாளர் உரிம ஒப்பந்தத்தில் கையெழுத்திடச் சொல்லி ஒரு bot கேட்கும். அது கேட்கும் ஒரு வாக்கியத்தைப் பதிலாக எழுதவும்.

தேர்வுகள்

ஒரு மாற்றம் எங்கே போகிறது

மாற்றம்	செல்ல வேண்டிய இடம்
புதிய route	Modules
புதிய module	Modules. முதலில் issue திறக்கவும்
நிறுத்திவைக்கப்பட்ட வசதி	அமைவு
ஒரு பதிப்பு வெளியீடு	பதிப்பு வெளியிடுதல். பராமரிப்பாளர்களுக்கு மட்டும்

நல்ல pull request எப்படி இருக்கும்

Code ஏன் அப்படிச் செய்கிறது என்று சொல்லும் கருத்துகளை எழுதவும். கருத்துகளில் roadmap எண்கள், தேதிகள், பெயர்கள், em dash எதுவும் வேண்டாம்.
Issue சொற்களைப் பற்றியதாக இல்லாவிட்டால், பயன்பாட்டின் சொற்களை மாற்ற வேண்டாம்.
வெளியான API பாதைகள், புலப் பெயர்கள், அமைப்பு விசைகள், அட்டவணைப் பெயர்கள், பணிப் பெயர்கள் ஆகியவற்றை அப்படியே வைக்கவும். சேர்க்கலாம், பெயர் மாற்றக் கூடாது.

இது வேலை செய்யவில்லை என்றால்

அறிகுறி. ஒரு structure சோதனை தோல்வியடைகிறது. காரணம். செய்தி கோப்பையும் விதியையும் குறிப்பிடும். தீர்வு. Code-ஐ நகர்த்தவும், அல்லது மேல் module-இடமிருந்து எளிய தரவை அனுப்பவும். Modules பக்கத்தைப் பார்க்கவும்.

அறிகுறி. Web app பழையதாகத் தெரிகிறது. காரணம். நிரல் தன்னுள் இணைத்த build-ஐயே வழங்குகிறது. தீர்வு. நிரலுக்கு முன் web app-ஐ மீண்டும் உருவாக்கவும்.

அறிகுறி. End-to-end சோதனைகள் தொடங்கவில்லை. காரணம். சோதனை browser நிறுவப்படவில்லை. தீர்வு. npx --prefix app/frontend playwright install chromium என்பதை இயக்கவும்.

நிபுணர்களுக்கு

ஒரு pull request பின்பற்ற வேண்டிய விதிகள்

ஒரு module மற்றொரு module-உடன் அதன் service (Go) அல்லது அதன் index.ts (web) வழியாக மட்டுமே பேசும். அதன் store வழியாகவோ கோப்புகள் வழியாகவோ ஒருபோதும் கூடாது.
SQL என்பது ஒரு module-இன் store*.go கோப்புகளில் மட்டும், அந்த module-இன் சொந்த அட்டவணைகளின் மேல் மட்டும் இருக்கும்.
ஒரு web பகுதி 2 அல்லது அதற்கு மேற்பட்ட modules பயன்படுத்தினால் மட்டுமே lib/ui-க்குப் போகும்.
util, common, shared, helpers package-கள் இல்லை.
ஒவ்வொரு வெளி அழைப்பும் core/outbound வழியாகச் செல்லும்.

சோதனைகள் இந்த விதிகளைச் சரிபார்க்கின்றன, அதனால் தவறான import build-ஐத் தோல்வியடையச் செய்யும். முழுப் பட்டியலும் சோதனைப் பெயர்களும் Modules பக்கத்தில் உள்ளன.

CI என்ன இயக்குகிறது

Job	இயக்குவது
Web	`check`, `lint`, `test`, `build`, end-to-end தொகுப்பு
Go	`amd64`, `arm64` ஆகியவற்றில் `go build`, `go vet`, `go test -timeout 60m ./...`, native ஆகவும் emulation-இலும்
Race	`go test -race ./...`
Contract	`openapi.json` பொருத்தம், ஒவ்வொரு route-இலும் scope சோதனைகள், பதிவிறக்கித் தொகுப்பு
Fault and scale	Crash, மெதுவான எழுத்து, மோசமான வெளிச் சேவை, நினைவக இயக்கங்கள்
Image	ஒரு மேம்பாட்டு image உருவாகி, தொடங்கி, தன் பதிப்பைச் சொல்கிறது

நீண்ட இயக்கங்களின் விவரங்கள் சோதனை பக்கத்தில் உள்ளன.

தொடர்புடையவை

HolyArrs இலவசம். இது உங்கள் நேரத்தைச் சேமித்திருந்தால், GitHub-இல் நட்சத்திரம் இடுங்கள், ஆதரவளியுங்கள் அல்லது எனக்கு ஒரு காபி வாங்கித் தாருங்கள்.