வலைபெயர்ப்பு தொகுதிகளுக்கு பங்களிக்கிறது¶
முக்கிய களஞ்சியத்தைத் தவிர, வலைபெயர்ப்பு பல பைத்தான் தொகுதிகளைக் கொண்டுள்ளது. இவை அனைத்தும் ஒரே கட்டமைப்பைப் பின்பற்றுகின்றன, மேலும் இந்த ஆவணம் அவை அனைத்தையும் உள்ளடக்கியது.
எடுத்துக்காட்டாக, இது பின்வருவனவற்றை உள்ளடக்குகிறது:
wlc, Python client library, see வலைபெயர்ப்பு கிளையன்ட்
translation-finder, used to discover translatable files in the repository
language-data, language definitions for Weblate, see மொழி வரையறைகள்
உள்ளமைக்கப்பட்ட மொழி வரையறைகளை விரிவுபடுத்துதல்¶
The language definitions are in the language-data repository.
You are welcome to add missing language definitions to languages.csv,
other files are generated from that file. The columns in the CSV file correspond to
மொழி வரையறைகள்.
உரிமம் மற்றும் பதிப்புரிமை¶
குறியீட்டை பங்களிக்கும் போது, உங்கள் மாற்றங்களையும் புதிய குறியீட்டை களஞ்சியம் ஏற்கனவே பயன்படுத்தும் அதே உரிமத்தின் கீழ் வைக்க ஒப்புக்கொள்கிறீர்கள், இல்லையெனில் கூறப்பட்டு ஒப்புக் கொள்ளாவிட்டால்.
See also
வலைபெயர்ப்பு உரிமம் explains licensing in more details.
ஒரு நல்ல இணைப்பு எழுதுதல்¶
தனி மாற்றங்களை எழுதுங்கள்¶
11 ஒற்றைப்படை சிக்கல்களை சரிசெய்வதாகக் கூறப்படும் ஒரு பெரிய பேட்சைப் பெறும்போது அது எரிச்சலூட்டுகிறது, ஆனால் விவாதங்களும் கருத்துக்களும் அவர்களில் 10 பேருடன் உடன்படவில்லை அல்லது அவர்களில் 9 பேர் ஏற்கனவே வித்தியாசமாக சரி செய்யப்பட்டுள்ளனர். இந்த மாற்றத்தை ஒன்றிணைக்கும் நபர் ஒற்றை சுவையான இணைப்பை எங்காவது இருந்து பிரமாண்டமான ஆதாரங்களின் குவியலுக்குள் பிரித்தெடுக்க வேண்டும், மேலும் இது நிறைய கூடுதல் வேலைகளை உருவாக்குகிறது.
முன்னுரிமை, ஒரு சிக்கலை நிவர்த்தி செய்யும் ஒவ்வொரு பிழைத்திருத்தமும் அதன் சொந்த விளக்கில் இருக்க வேண்டும்/அதன் சொந்த விளக்கத்துடன்/செய்திகளை அவர்கள் சரிசெய்ததை சரியாகக் குறிப்பிட வேண்டும், இதனால் அனைத்து மாற்றங்களும் பராமரிப்பாளர் அல்லது பிற ஆர்வமுள்ள தரப்பினரால் தேர்ந்தெடுக்கப்பட்டதாகப் பயன்படுத்தப்படலாம்.
மேலும், தனித்தனி மாற்றங்கள் எதிர்காலத்தில் சிக்கல்களையும் பின்னடைவையும் கண்காணிக்க மிகவும் சிறப்பாக பிரிக்க உதவுகின்றன.
ஆவணப்படுத்துதல்¶
ஆவணங்கள் ஒரு கடினமான பணியாக இருக்கலாம்; இருப்பினும், யாராவது அதை முடிக்க வேண்டியது தேவை. குறியீடு மாற்றங்களுடன் ஆவணங்களை நீங்கள் சமர்ப்பித்தால் அது விசயங்களை மிகவும் எளிதாக்குகிறது. ஆவண முறைகள், சிக்கலான குறியீடு தொகுதிகள் அல்லது பயனர் காணக்கூடிய அம்சங்களுக்கு நினைவில் கொள்க.
சோதனை வழக்குகள்¶
சோதனைகள் நற்பொருத்தங்கள் அவை செயல்படுகின்றன என்பதை விரைவாக சரிபார்க்க அனுமதிக்கின்றன. இந்த சூழ்நிலையை பராமரிக்கவும், அதை மேம்படுத்தவும், சேர்க்கப்பட்ட அனைத்து புதிய நற்பொருத்தங்கள் மற்றும் செயல்பாடுகள் சோதனை தொகுப்பில் சோதிக்கப்பட வேண்டும். சேர்க்கப்பட்ட ஒவ்வொரு அம்சமும் குறைந்தது ஒரு செல்லுபடியாகும் சோதனை வழக்கைப் பெற வேண்டும், அது ஆவணப்படுத்தப்பட்டதாக செயல்படுகிறது என்பதை சரிபார்க்கிறது.
செய்திகளைச் செய்யுங்கள்¶
Git commits should follow Conventional Commits specification.
Type checking¶
Any new code should utilize PEP 484 type hints. We are using mypy to check (because it has a Django plugin that makes type checking of Django apps doable).
The code base is not yet completely covered by type annotations, but some modules are already enforced for type checking in the CI.
குறியீட்டு மற்றும் குறியீட்டைக் குறைத்தல்¶
The code should follow PEP 8 coding guidelines and should be formatted using ruff code formatter.
To check the code quality, you can use ruff, its configuration is
stored in 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
பாதுகாப்பாக குறியீட்டு¶
Any code for Weblate should be written with Security by Design Principles in mind.
AI வழிகாட்டுதல்கள்¶
திட்டத்திற்கு உள்ளடக்கத்தை பங்களிக்கும்போது, அதைப் பயன்படுத்த எங்களுக்கு இசைவு அளிக்கிறீர்கள், அதை எங்களுக்கு விநியோகிக்க நீங்கள் அனுமதிக்கப்படுவதை உறுதிசெய்கிறீர்கள். எங்களுக்கு ஒரு மாற்றத்தை சமர்ப்பிப்பதன் மூலம், மாற்றங்கள் திட்டத்தால் ஏற்றுக்கொள்ளப்படலாம் மற்றும் ஏற்றுக்கொள்ளப்பட வேண்டும் என்பதை ஒப்புக்கொள்கிறீர்கள் மற்றும் திட்ட உரிமத்தின் கீழ் மறுபகிர்வு செய்யப்பட வேண்டும். உரிமம் பெறாத குறியீடு எதுவும் திட்டத்திற்கு சமர்ப்பிக்கப்படவில்லை என்பதை உறுதிப்படுத்த சுமை அவர்கள் மீது உள்ளது என்பதை ஆசிரியர்கள் வெளிப்படையாக அறிந்திருக்க வேண்டும்.
இது AI பயன்படுத்தப்படுகிறதா இல்லையா என்பதிலிருந்து சுயாதீனமாக உள்ளது.
ஒரு இழுப்பு கோரிக்கையை பங்களிக்கும்போது, நிச்சயமாக, முன்மொழிவு நல்ல தகுதி வாய்ந்தது என்பதையும், எங்கள் வழிகாட்டுதல்களைப் பின்பற்றும் சிறந்த முயற்சி என்பதையும் நீங்கள் எப்போதும் உறுதிப்படுத்த வேண்டும். கட்டைவிரல் ஒரு அடிப்படை விதி என்னவென்றால், AI இன் உதவியுடன் பங்களிப்பு செய்யப்பட்டது என்பதை யாராவது கண்டுபிடிக்க முடிந்தால், உங்களுக்கு அதிக வேலை இருக்கிறது.
திட்டத்தில் AI உதவியுடன் எழுதப்பட்ட குறியீட்டை நாங்கள் ஏற்றுக்கொள்ளலாம், ஆனால் குறியீடு இன்னும் குறியீட்டு தரங்களைப் பின்பற்ற வேண்டும், தெளிவாக எழுதப்பட வேண்டும், ஆவணப்படுத்தப்பட வேண்டும், அம்ச சோதனை வழக்குகள் மற்றும் நம்மிடம் உள்ள அனைத்து சாதாரண தேவைகளையும் பின்பற்ற வேண்டும்.