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

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

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

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

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

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

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

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

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