உரிமம் மற்றும் பதிப்புரிமை¶

குறியீட்டை பங்களிக்கும் போது, உங்கள் மாற்றங்களையும் புதிய குறியீட்டை களஞ்சியம் ஏற்கனவே பயன்படுத்தும் அதே உரிமத்தின் கீழ் வைக்க ஒப்புக்கொள்கிறீர்கள், இல்லையெனில் கூறப்பட்டு ஒப்புக் கொள்ளாவிட்டால்.

ஒரு நல்ல இணைப்பு எழுதுதல்¶

தனி மாற்றங்களை எழுதுங்கள்¶

11 ஒற்றைப்படை சிக்கல்களை சரிசெய்வதாகக் கூறப்படும் ஒரு பெரிய பேட்சைப் பெறும்போது அது எரிச்சலூட்டுகிறது, ஆனால் விவாதங்களும் கருத்துக்களும் அவர்களில் 10 பேருடன் உடன்படவில்லை அல்லது அவர்களில் 9 பேர் ஏற்கனவே வித்தியாசமாக சரி செய்யப்பட்டுள்ளனர். இந்த மாற்றத்தை ஒன்றிணைக்கும் நபர் ஒற்றை சுவையான இணைப்பை எங்காவது இருந்து பிரமாண்டமான ஆதாரங்களின் குவியலுக்குள் பிரித்தெடுக்க வேண்டும், மேலும் இது நிறைய கூடுதல் வேலைகளை உருவாக்குகிறது.

முன்னுரிமை, ஒரு சிக்கலை நிவர்த்தி செய்யும் ஒவ்வொரு பிழைத்திருத்தமும் அதன் சொந்த விளக்கில் இருக்க வேண்டும்/அதன் சொந்த விளக்கத்துடன்/செய்திகளை அவர்கள் சரிசெய்ததை சரியாகக் குறிப்பிட வேண்டும், இதனால் அனைத்து மாற்றங்களும் பராமரிப்பாளர் அல்லது பிற ஆர்வமுள்ள தரப்பினரால் தேர்ந்தெடுக்கப்பட்டதாகப் பயன்படுத்தப்படலாம்.

மேலும், தனித்தனி மாற்றங்கள் எதிர்காலத்தில் சிக்கல்களையும் பின்னடைவையும் கண்காணிக்க மிகவும் சிறப்பாக பிரிக்க உதவுகின்றன.

ஆவணப்படுத்துதல்¶

ஆவணங்கள் ஒரு கடினமான பணியாக இருக்கலாம்; இருப்பினும், யாராவது அதை முடிக்க வேண்டியது தேவை. குறியீடு மாற்றங்களுடன் ஆவணங்களை நீங்கள் சமர்ப்பித்தால் அது விசயங்களை மிகவும் எளிதாக்குகிறது. ஆவண முறைகள், சிக்கலான குறியீடு தொகுதிகள் அல்லது பயனர் காணக்கூடிய அம்சங்களுக்கு நினைவில் கொள்க.

சோதனை வழக்குகள்¶

சோதனைகள் நற்பொருத்தங்கள் அவை செயல்படுகின்றன என்பதை விரைவாக சரிபார்க்க அனுமதிக்கின்றன. இந்த சூழ்நிலையை பராமரிக்கவும், அதை மேம்படுத்தவும், சேர்க்கப்பட்ட அனைத்து புதிய நற்பொருத்தங்கள் மற்றும் செயல்பாடுகள் சோதனை தொகுப்பில் சோதிக்கப்பட வேண்டும். சேர்க்கப்பட்ட ஒவ்வொரு அம்சமும் குறைந்தது ஒரு செல்லுபடியாகும் சோதனை வழக்கைப் பெற வேண்டும், அது ஆவணப்படுத்தப்பட்டதாக செயல்படுகிறது என்பதை சரிபார்க்கிறது.

செய்திகளைச் செய்யுங்கள்¶

Git கமிட்கள் Conventional Commits விவரக்குறிப்பைப் பின்பற்ற வேண்டும்.

வகை சரிபார்த்தல்¶

எந்த புதிய குறியீடும் PEP 484 வகை குறிப்புகளைப் பயன்படுத்த வேண்டும். நாங்கள் சரிபார்க்க mypy ஐப் பயன்படுத்துகிறோம் (ஏனென்றால் அதில் சாங்கோ செருகுநிரல் உள்ளது, இது சாங்கோ பயன்பாடுகளின் வகைச் சரிபார்ப்பைச் செய்யக்கூடியது).

குறியீட்டு அடிப்படையானது வகை சிறுகுறிப்புகளால் இன்னும் முழுமையாக மூடப்படவில்லை, ஆனால் சில தொகுதிகள் ஏற்கனவே தொஒ இல் வகை சரிபார்ப்பிற்காக செயல்படுத்தப்பட்டுள்ளன.

குறியீட்டு மற்றும் குறியீட்டைக் குறைத்தல்¶

குறியீடு PEP 8 குறியீட்டு வழிகாட்டுதல்களைப் பின்பற்ற வேண்டும் மற்றும் ruff குறியீடு வடிவமைப்பைப் பயன்படுத்தி வடிவமைக்கப்பட வேண்டும்.

குறியீட்டின் தரத்தை சரிபார்க்க, நீங்கள் ruff ஐப் பயன்படுத்தலாம், அதன் கட்டமைப்பு pyproject.toml இல் சேமிக்கப்படும்.

The easiest approach to enforce all this is to install pre-commit. The repository contains configuration for it to verify the committed files are sane. After installing it (it is already included in the pyproject.toml) turn it on by running pre-commit install in Weblate checkout. This way all your changes will be automatically checked.

எல்லா கோப்புகளையும் சரிபார்க்க, கைமுறையாக சோதனையைத் தூண்டலாம்:

pre-commit run --all

பாதுகாப்பாக குறியீட்டு¶

Weblateக்கான எந்தக் குறியீடும் வடிவமைப்புக் கோட்பாடுகளின் பாதுகாப்பு என்பதை மனதில் வைத்து எழுத வேண்டும்.

AI வழிகாட்டுதல்கள்¶

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

இது AI பயன்படுத்தப்படுகிறதா இல்லையா என்பதிலிருந்து சுயாதீனமாக உள்ளது.

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

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