- عنوان کتاب: Looks Good to Me -Constructive code reviews
- نویسنده: Adrienne Braganza
- حوزه: DevOps
- تعداد صفحه: 354
- زبان اصلی: انگلیسی
- نوع فایل: pdf
- حجم فایل: 9.07 مگابایت
آه، بررسی کد! ما به آنها نیاز داریم، اما از آنها وحشت داریم. ما آنها را انجام میدهیم، اما نه به خوبی. و با وجود ابزارهایی که در اختیار داریم، هنوز هم میتوانیم همه چیز را خراب کنیم. چگونه با PR های غول پیکر برخورد کنیم؟ چگونه بررسی کد را کوتاهتر کنیم؟ چرا نمیتوانیم نظرات بررسی کد مؤثر بنویسیم؟ آیا SSDaaRB (Single Senior Developer as a Reviewer Bottleneck) چیزی است که باید بپذیریم؟ آیا محکوم به بحث با همکارانمان در مورد پیادهسازیهای فنی هستیم؟ آیا بررسی کد همیشه اینگونه خواهد بود؟ این سؤالات (و بسیاری موارد دیگر) موضوعاتی هستند که من در طول 12 سال فعالیت حرفهایام به سمت آنها جذب شدهام. من در تیمهایی کار کردهام که اصلاً فرآیند بررسی کد نداشتند. من در تیمهایی کار کردهام که فرآیندی داشتند، اما به سختی اجرا میشد. من در تیمهایی کار کردهام که فرآیند فوقالعادهای داشتند. و من در تیمهایی کار کردهام که این فرآیند باعث میشد بخواهم موهایم را از تنشان بکنم، زیرا بسیار خستهکننده بود. همانطور که در آن نقشها، چه در فناوریها و چه در فرآیندهای تیمی، دانش کسب کردم، نتوانستم جلوی خودم را بگیرم و به این سؤالات برنگشتم. با نگاهی به گذشته، متوجه شدم که بخش بزرگی از اینکه آیا از کار با تیمهای خاص لذت بردم یا نه، به دوستانه و مؤثر بودن فرآیند بررسی کد ما بستگی داشت. بله، وقتی یک توسعهدهنده نرمافزار حرفهای میشوید، کد مینویسید، اما زمان بسیار بیشتری را صرف خواندن و فهمیدن آن میکنید. همچنین زمان زیادی را صرف خواندن کدی میکنید که خودتان ننوشتهاید! این درک باعث شد که به بررسی کدها از زاویه دیگری نگاه کنم. اخیراً، به عنوان یک مدافع توسعهدهنده، با تمرکز بر آموزش نحوه انجام «کارهای توسعهدهنده» به توسعهدهندگان، درآمد خوبی کسب کردهام. من به طور تصادفی در این نقش قرار گرفتم، اما خوشحالم که این کار را کردم. پیشینه توسعه نرمافزار من (و مهارتهای ظاهری من در سخنرانی عمومی و ارتباطات نوشتاری) واقعاً به ایجاد محتوای آموزشی فنی درخشان کمک میکند. بخش بزرگی از این به این دلیل است که دوست دارم روی آنچه که معتقدم ضروری هستند تمرکز کنم – چیزهایی که معمولاً فراموش میکنیم یا فرض میکنیم همه در صنعت توسعه نرمافزار از قبل میدانند – و آنها را به روشی قابل فهم آموزش دهم. وقتی منینگ از من پرسید که با توجه به فرصت انتخاب هر چیزی، میخواهم در مورد چه موضوعی بنویسم، انتخاب کاملاً واضح بود: بررسی کد. آیا منابع دیگری در مورد بررسی کد وجود دارد؟ قطعاً. آیا توسعهدهندگان دیگر بینشهایی دارند که ممکن است برای شما بهتر باشد؟ تضمین میکنم. اما یک واقعیت باقی ماند: هیچ منبع «رسمی» یا واحد و جامعی در مورد بررسی کد وجود ندارد، نه به آن شکلی که من تصور میکردم. میخواستم به سؤالاتی که قبلاً ذکر کردم پاسخ دهم. میخواستم روی فرآیند بررسی کد و پویایی تیمی که آن را احاطه کرده است تمرکز کنم، نه اینکه بوهای کد را که باید مراقب آنها باشید فهرست کنم (اگر همه را در نظر میگرفتم، این یک کتاب عظیم میشد). میخواستم تمام بینشها، تجربیات، استراتژیها و تاکتیکهایی را که در طول حرفهام آموخته و جمعآوری کردهام، برای ایجاد یک بررسی کد بهتر به اشتراک بگذارم. و میخواستم این کار را به روشی دوستانه و قابل دسترس انجام دهم. میخواستم کتاب بررسی کد باشم. بنابراین این کاری بود که انجام دادم. اکنون که این کار عاشقانه را میخوانید، مشتاقم که شما را در جنبه انسانی بررسی کد راهنمایی کنم. میخواهم شما بهتر از LGTM عمل کنید. میخواهم بررسیهای کد شما عالی باشد!
Ah, code reviews! We need them, but we dread them. We do them, but not well. And despite the tools we have at our disposal, we still manage to mess things up. How do we deal with gigantic PRs? How do we make code reviews shorter? Why can’t we write effective code review comments? Is SSDaaRB (Single Senior Developer as a Reviewer Bottleneck) something we just have to accept? Are we doomed to debate with our colleagues over technical implementations? Will code reviews always be like this? These questions (and plenty more) are the matters that I gravitated toward in my now 12-year career. I’ve worked on teams that had no code review process at all. I’ve worked on teams that had a process, but it was barely enforced. I’ve worked on teams that had a wonderful process. And I’ve worked on teams where the process made me want to pull my hair out because it was so tedious. As I gained knowledge in those roles, both in technologies and team processes, I couldn’t help but return to those questions. Looking back, I realized a big part of whether I enjoyed working with certain teams was whether our code review process was amicable and effective. Yes, you write code when you become a professional software developer, but you spend way more time reading and making sense of it. You also spend a lot of time reading code you didn’t write! This realization made me look at code reviews in a different light. More recently, I’ve been earning pretty pennies as a developer advocate, focused on teaching developers how to do “developer things” well. I accidentally fell into this role, but I’m glad I did; my software development background (and apparent skills in public speaking and written communication) really helps in creating technical educational content that shines. A big part of that is because I like to focus on what I believe are essentials—things that we tend to forget or assume that everyone already knows in the software development industry—and teach them in an approachable way. When Manning asked me what topic I would want to write about, given the chance to choose anything, the choice was absolutely clear: code reviews. Are there other resources on code reviews? Absolutely. Do other developers have insights that may relate better to you? Guaranteed. But one fact remained: there is no “official” or single, comprehensive resource on code reviews, not in the way I imagined. I wanted to answer the questions I previously mentioned. I wanted to focus on the code review process and the team dynamics that surround it rather than list out code smells to watch out for (that would be a huge book if I accommodated everyone). I wanted to share all the insights, experience, strategies, and tactics I’ve learned and collected throughout my career to build a better code review. And I wanted to do it in a friendly, approachable way. I wanted to be THE book on code reviews. So that’s what I did. Now that you’re reading this labor of love, I’m excited to guide you through the human side of code reviews. I want you to do better than LGTM . I want your code reviews to be great!
این کتاب را میتوانید از لینک زیر بصورت رایگان دانلود کنید:

نظرات کاربران