புல் ரிக்வெஸ்ட் மதிப்பாய்வை வழங்குதல்

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

பங்களிப்புகளை ஏன் மதிப்பாய்வு செய்ய வேண்டும்?

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

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

நான் மதிப்பாய்வு செய்யலாமா?

ஆம்! BeeWare-இல் நீங்கள் காணும் எந்தவொரு புல் ரிக்வெஸ்ட்டிலும் ஒரு மதிப்பாய்வை வழங்கலாம்.

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

புல் ரிக்வெஸ்ட் மதிப்பாய்வில் பங்களித்தல்

புல் ரிக்வெஸ்ட் மதிப்பாய்வை வழங்குதல்

புல் ரிக்வெஸ்ட் மதிப்பாய்வை வழங்குதல்

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

விமர்சனம் செய்வதற்கு முன் சிந்தியுங்கள்

ஒரு மதிப்பாய்வில் ஈடுபடுவதற்கு முன், சிந்தியுங்கள். மதிப்பாய்வாளர்களாகிய நாம், நாம் அனுப்பவிருக்கும் பதில் பின்வருவனவற்றில் ஏதேனும் ஒன்றா என்பதைக் கருத்தில் கொள்ள வேண்டும்:

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

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

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

GitHub மதிப்பாய்வு பரிந்துரைகள்

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