Technical Code Review

بازبینی فنی کد

You've written a new piece of code for a project and want a fellow developer to review it for logic, efficiency, potential bugs, or adherence to coding standards.

برای پروژه‌ای کد تازه‌ای نوشته‌اید و می‌خواهید یکی از توسعه‌دهندگان همکارتان آن را از نظر منطق، کارایی، باگ‌های احتمالی یا رعایت استانداردهای کدنویسی بررسی کند.

گفت‌وگو9

Technical Code Review
David
David

Hey Mia, do you have a few minutes? I just finished writing that new module for the user authentication system and was hoping you could give it a quick once-over.

سلام میا، چند دقیقه وقت داری؟ تازه نوشتن ماژول جدید سیستم احراز هویت کاربر رو تموم کردم و امیدوار بودم یه نگاه سریع بهش بندازی.

Mia
Mia

Sure, David, I can definitely take a look. What specifically are you looking for feedback on? Logic, efficiency, or potential edge cases?

حتماً دیوید، با کمال میل نگاهش می‌کنم. دقیقاً دوست داری درباره‌ی چه چیزهایی نظر بدم؟ منطق، کارایی یا حالت‌های خاص و غیرمعمول؟

David
David

All of the above, honestly. But mainly, I'm concerned about the error handling. I tried to cover all bases, but I always value a second pair of eyes on that.

راستش همه‌شون. ولی بیشتر نگران مدیریت خطاها هستم. سعی کردم همه‌ی حالت‌ها رو در نظر بگیرم، اما همیشه خوبه یکی دیگه هم یه نگاهی بندازه.

Mia
Mia

Got it. So, robust error handling is the key. And maybe also check for any performance bottlenecks, especially since it's auth-related. Where's the code located?

متوجه شدم. پس مدیریت خطای قابل‌اتکا نکته‌ی اصلیه. شاید بد نباشه گلوگاه‌های عملکردی رو هم بررسی کنم، مخصوصاً چون به احراز هویت مربوطه. کد کجاست؟

David
David

It's in the feature branch 'auth-v2-module' on GitHub. I've already pushed my latest changes. Let me send you the direct link to the pull request.

تو شاخه‌ی «auth-v2-module» در گیت‌هابه. آخرین تغییراتم رو هم فرستادم. بذار لینک مستقیم درخواست ادغام رو برات بفرستم.

Mia
Mia

Perfect, thanks. I'll carve out some time after this meeting to go through it. Is there anything else I should be aware of, like specific design patterns you used?

عالیه، ممنون. بعد از این جلسه یه وقتی می‌ذارم و کامل بررسیش می‌کنم. چیز دیگه‌ای هست که باید بدونم؟ مثلاً از الگوی طراحی خاصی استفاده کردی؟

David
David

Not really anything out of the ordinary, just standard practices. But let me know if anything looks off or if you think there's a more Pythonic way to do something.

نه، چیز خاصی نیست؛ فقط روش‌های استاندارد. ولی اگه چیزی به نظرت درست نبود یا فکر کردی می‌شه به شیوه‌ی پایتونیک‌تری انجامش داد، بهم بگو.

Mia
Mia

Will do. I'll add comments directly on the pull request. And I'll ping you once I'm done. Should be by end of day.

حتماً. نظراتم رو مستقیم روی درخواست ادغام می‌نویسم و وقتی تموم شد بهت پیام می‌دم. احتمالاً تا آخر امروز.

David
David

Awesome, thanks a ton, Mia! This is a huge help.

عالیه، خیلی ممنون میا! واقعاً کمک بزرگیه.

واژگان10

  • once-overنگاه سریع؛ بررسی سرسری

    A quick and informal review of something, like checking work briefly without deep analysis. Use it when asking for a fast opinion on a task.

    «once-over» یعنی بررسی سریع و غیررسمی چیزی؛ مثلاً کاری را بدون تحلیل عمیق، مختصر مرور کردن. وقتی از کسی می‌خواهید سریع نظرش را درباره‌ی کاری بگوید، از این عبارت استفاده می‌شود.

  • feedbackبازخورد؛ نظر

    Suggestions or opinions given to improve something. In work, it's common to ask for feedback on projects to make them better.

    «feedback» پیشنهادها یا نظرهایی است که برای بهتر کردن چیزی ارائه می‌شود. در محیط کار معمول است که برای بهتر شدن پروژه‌ها، درباره‌شان بازخورد بخواهند.

  • edge casesحالت‌های خاص؛ موارد مرزی

    Unusual or extreme situations in programming that might cause problems. Developers test for these to ensure code works in all scenarios.

    «edge cases» موقعیت‌های غیرمعمول یا حدی در برنامه‌نویسی است که ممکن است مشکل‌ساز شوند. توسعه‌دهندگان این موارد را آزمایش می‌کنند تا مطمئن شوند کد در همه‌ی شرایط درست کار می‌کند.

  • error handlingمدیریت خطا

    The part of code that manages mistakes or unexpected issues, like user errors. It's crucial for making software reliable.

    «error handling» بخشی از کد است که خطاها یا مشکلات پیش‌بینی‌نشده، مثل اشتباه‌های کاربر، را مدیریت می‌کند. این بخش برای قابل‌اعتماد بودن نرم‌افزار ضروری است.

  • cover all basesهمه‌ی جوانب را در نظر گرفتن

    To prepare for or address every possible situation thoroughly, like an idiom from baseball meaning to be complete.

    «cover all bases» یعنی همه‌ی موقعیت‌های ممکن را به‌طور کامل پیش‌بینی یا بررسی کردن. این اصطلاح از بیسبال می‌آید و بر کامل و همه‌جانبه بودن دلالت دارد.

  • second pair of eyesنظر یک نفر دیگر؛ جفت چشم دوم

    Getting another person to review your work for fresh perspective and to catch mistakes you might miss.

    «second pair of eyes» یعنی از شخص دیگری بخواهید کارتان را بررسی کند تا با دیدی تازه، اشتباه‌هایی را پیدا کند که ممکن است از چشم شما دور مانده باشند.

  • robustمقاوم؛ قابل‌اتکا

    Strong and able to handle problems well, especially in software meaning reliable under stress or errors.

    «robust» یعنی قوی و توانمند در مواجهه با مشکلات. در نرم‌افزار معمولاً به چیزی گفته می‌شود که در شرایط سخت یا هنگام بروز خطا هم قابل‌اعتماد باشد.

  • pull requestدرخواست ادغام (پول‌ریکوئست)

    A way in GitHub to propose changes to code for review and merging into the main project. It's a key tool in team coding.

    «pull request» قابلیتی در گیت‌هاب است که با آن تغییرات کد را برای بررسی و ادغام در پروژه‌ی اصلی پیشنهاد می‌دهند. این ابزار در کدنویسی گروهی بسیار مهم است.

  • Pythonicپایتونیک؛ مطابق سبک پایتون

    Following the best practices and style of the Python programming language, making code clean and efficient.

    «Pythonic» یعنی پیروی از بهترین روش‌ها و سبک زبان برنامه‌نویسی پایتون، به‌طوری‌که کد خوانا و کارآمد باشد.

  • pingپیام دادن؛ خبر دادن

    To quickly contact someone, like sending a short message or notification. Informal in tech for 'notify me later.'

    «ping» یعنی سریع با کسی تماس گرفتن؛ مثلاً یک پیام کوتاه یا اعلان فرستادن. در فضای فناوری، این واژه به‌صورت غیررسمی برای «بعداً خبرم کن» به کار می‌رود.

جملات کلیدی9

  1. 1

    Hey Mia, do you have a few minutes?

    سلام میا، چند دقیقه وقت داری؟

    This is a polite, casual way to ask if someone is available for a short talk. Use it in informal work settings to start a conversation without being too direct. The question form with 'do you have' makes it open and respectful.

    این یک روش دوستانه و مؤدبانه برای پرسیدن این است که کسی برای یک گفت‌وگوی کوتاه وقت دارد یا نه. در محیط کاری غیررسمی، برای شروع صحبت بدون اینکه خیلی مستقیم باشید، از آن استفاده کنید. ساختار پرسشی «do you have» (وقت داری؟) پرسش را دوستانه و محترمانه می‌کند.

  2. 2

    I was hoping you could give it a quick once-over.

    امیدوار بودم یه نگاه سریع بهش بندازی.

    A soft request for a brief review, using 'was hoping' to sound polite and indirect. Useful when asking colleagues for help on work without pressure; 'once-over' adds informality.

    این جمله درخواستی ملایم برای یک بررسی کوتاه است. استفاده از «was hoping» (امیدوار بودم) لحن را مؤدبانه و غیرمستقیم می‌کند. برای درخواست کمک کاری از همکاران، بدون اینکه به آن‌ها فشار بیاورید، کاربرد دارد؛ «once-over» (نگاه سریع) هم به جمله لحنی غیررسمی می‌دهد.

  3. 3

    What specifically are you looking for feedback on?

    دقیقاً دوست داری درباره‌ی چه چیزهایی نظر بدم؟

    This clarifies what kind of input is needed, using 'what specifically' to narrow down details. Great for professional discussions to show you're focused and helpful; the present continuous 'are you looking' fits ongoing situations.

    این جمله روشن می‌کند که دقیقاً چه نوع نظری لازم است. «what specifically» (دقیقاً چه چیزی) محدوده‌ی پرسش را مشخص‌تر می‌کند. در گفت‌وگوهای کاری، این جمله نشان می‌دهد که می‌خواهید کمک کنید و روی موضوع متمرکز هستید. زمان حال استمراری در «are you looking» برای موقعیتی که همین حالا در جریان است مناسب است.

  4. 4

    All of the above, honestly.

    راستش همه‌شون.

    Means 'everything you mentioned,' with 'honestly' adding sincerity. It's a concise way to agree broadly in conversations; useful for feedback requests to cover multiple points without listing them.

    یعنی «همه‌ی چیزهایی که گفتی» و «honestly» (راستش) صمیمیت و صداقت را می‌رساند. راهی کوتاه برای موافقت کلی در گفت‌وگوست؛ وقتی چند موضوع مختلف را برای گرفتن بازخورد مطرح می‌کنید، می‌توانید بدون برشمردن دوباره‌ی آن‌ها از این جمله استفاده کنید.

  5. 5

    I tried to cover all bases, but I always value a second pair of eyes on that.

    سعی کردم همه‌ی جوانب رو در نظر بگیرم، اما همیشه خوبه یکی دیگه هم یه نگاهی بندازه.

    Explains effort made while humbly seeking review; 'cover all bases' is an idiom for thoroughness, and 'second pair of eyes' means another opinion. Use in team work to show collaboration and openness to improvement.

    این جمله به تلاشی که کرده‌اید اشاره می‌کند و در عین حال، فروتنانه درخواست بررسی دوباره دارد. «cover all bases» یعنی همه‌ی جوانب را کامل در نظر گرفتن و «second pair of eyes» یعنی نظر یا بررسی یک نفر دیگر. در کار گروهی از این جمله استفاده کنید تا روحیه‌ی همکاری و آمادگی برای بهتر شدن را نشان دهید.

  6. 6

    I'll carve out some time after this meeting to go through it.

    بعد از این جلسه یه وقتی می‌ذارم و کامل بررسیش می‌کنم.

    'Carve out' means to make or reserve time intentionally; this promises action politely. Helpful for committing to tasks in busy work environments, using future 'I'll' for reliability.

    «carve out» یعنی عمداً زمانی را خالی یا رزرو کردن؛ این جمله با لحنی مؤدبانه قول انجام کاری را می‌دهد. در محیط‌های کاری شلوغ، برای متعهد شدن به انجام کارها مفید است. استفاده از «I'll» (من ... خواهم) نشان می‌دهد که پیگیری خواهید کرد.

  7. 7

    Let me know if anything looks off or if you think there's a more Pythonic way to do something.

    اگه چیزی به نظرت درست نبود یا فکر کردی می‌شه به شیوه‌ی پایتونیک‌تری انجامش داد، بهم بگو.

    Invites specific comments, with 'looks off' meaning seems wrong informally. 'Let me know' is a common phrase for requesting updates; useful in reviews to encourage detailed, constructive feedback.

    این جمله طرف مقابل را به بیان نظرهای مشخص دعوت می‌کند. «looks off» یعنی غیررسمی بگوییم چیزی درست به نظر نمی‌رسد. «Let me know» (بهم بگو) عبارتی رایج برای درخواست خبر یا نظر است؛ در بازبینی کد از آن استفاده کنید تا دیگران را به ارائه‌ی بازخورد دقیق و سازنده تشویق کنید.

  8. 8

    I'll ping you once I'm done.

    وقتی کارم تموم شد بهت پیام می‌دم.

    'Ping' is tech slang for quick notification; 'once I'm done' uses time clause for sequence. This sets expectations clearly in professional emails or chats, showing you'll follow up.

    «Ping» اصطلاحی غیررسمی در دنیای فناوری برای خبر دادن سریع است و «once I'm done» (وقتی کارم تمام شد) با اشاره به زمان، ترتیب کارها را مشخص می‌کند. این عبارت در ایمیل‌ها یا گفت‌وگوهای کاری، زمان‌بندی را روشن می‌کند و نشان می‌دهد که پیگیری خواهید کرد.

  9. 9

    Awesome, thanks a ton, Mia! This is a huge help.

    عالیه، خیلی ممنون میا! واقعاً کمک بزرگیه.

    Enthusiastic thanks using slang like 'awesome' and 'thanks a ton' for emphasis. Expresses strong gratitude in informal work; 'huge help' highlights importance, good for building positive relationships.

    این جمله با واژه‌های غیررسمی مثل «awesome» (عالیه) و «thanks a ton» (خیلی ممنون) قدردانی پرشوری را بیان می‌کند. در محیط کاری دوستانه برای نشان دادن قدردانی زیاد کاربرد دارد؛ «huge help» (کمک بزرگی) اهمیت این کمک را برجسته می‌کند و به ایجاد رابطه‌ای مثبت کمک می‌کند.

از English Dialogue لذت می‌برید؟

ثبت یک امتیاز سریع در Microsoft Store به زبان‌آموزان دیگر کمک می‌کند این برنامه را پیدا کنند.