Warm-up
Warm-up — Pregătire pentru lecție. Răspunde la întrebări introductive despre experiența ta cu documentele de design și discuțiile de arhitectură din echipa ta.
Разминка — Вводные вопросы. Ответьте на вводные вопросы об упражнениях по английскому языку, связанным с проектированием систем и обсуждением архитектуры в вашей команде.
In this lesson you will
• you will learn the core structure and sections of a professional technical design doc
• you will understand how to use nominalisation to write objective and formal technical English
• you will master the vocabulary needed to solicit feedback and align stakeholders on architecture decisions
Warm-up
1. Have you ever written a design doc or an RFC? What was the most challenging part of that process?
2. How does your team usually handle feedback on new architecture proposals?
3. Do you prefer reading detailed code or a high-level overview when you join a new project?
Sources: photo by ThisIsEngineering on Pexels
Despre această lecție
Acest curs te ajută să stăpânești arta de a redacta un document de arhitectură clar și convingător în limba engleză. Vei învăța să eviți capcanele detaliilor inutile de cod în primele etape ale proiectului.
Scrierea unui document de design (design doc) este un pas critic în cariera oricărui inginer software upper-intermediate care dorește să facă trecerea spre roluri de leadership tehnic. Această lecție se concentrează pe structura corectă a unui document de arhitectură, punând accent pe definirea clară a obiectivelor, a alternativelor luate în considerare și a non-obiectivelor (non-goals). Vei învăța cum să soliciți feedback în mod eficient de la stakeholderi și cum să prezinți o viziune de ansamblu fără a te pierde în detalii de implementare premature.
Lecția este special concepută pentru profesioniștii IT din Moldova care vorbesc româna sau rusa ca limbă maternă. Vorbitorii de limbi slave și românice au adesea tendința de a traduce mot-à-mot structuri verbale lungi și informale, ceea ce face ca documentele lor tehnice să sune prea narative sau chiar subiective. De exemplu, în loc să folosească o exprimare directă și nominalizată precum 'the availability of the system' (disponibilitatea sistemului), aceștia folosesc adesea clauze lungi de tipul 'how the system is available'. Acest curs corectează aceste deprinderi prin predarea nominalizării.
Nominalizarea — transformarea verbelor și adjectivelor în substantive (de exemplu, de la 'decide' la 'the decision to', sau de la 'available' la 'availability') — este piatra de temelie a stilului academic și tehnic formal în limba engleză. Utilizarea corectă a acestei tehnici gramaticale îți va permite să suni mult mai precis, obiectiv și autoritar în fața clienților internaționali și a echipei de management.
La locul de muncă, abilitatea de a redacta un 'Request for Comments' (RFC) clar și de a alinia stakeholderii în jurul unei decizii de design îți va scurta semnificativ timpul necesar pentru obținerea aprobărilor (sign-off). În loc să porți discuții interminabile în care membrii echipei vorbesc unii pe lângă alții, vei putea prezenta argumente structurate, facilitând o cultură de colaborare bazată pe documente tehnice bine scrise.
Об этом уроке
Этот курс поможет вам освоить искусство составления чёткого и убедительного документа по архитектуре на английском языке. Вы научитесь избегать ловушек в виде лишних деталей кода на ранних этапах проекта.
Написание технического проекта (design doc) — это важный шаг в карьере любого инженера-программиста уровня upper-intermediate, который стремится перейти на позиции технического лидерства. Эта лекция посвящена правильной структуре архитектурного документа, уделяя особое внимание четкому определению целей, рассмотренных альтернатив и не-целей (non-goals). Вы узнаете, как эффективно запрашивать обратную связь у стейкхолдеров и представлять общую картину, не углубляясь в преждевременные детали реализации.
Лекция специально разработана для IT-специалистов из Молдовы, для которых родным языком является румынский или русский. Носители славянских и романских языков часто склонны дословно переводить длинные и неформальные глагольные конструкции, из-за чего их технические документы звучат слишком повествовательно или даже субъективно. Например, вместо прямого и номинализированного выражения вроде 'the availability of the system' (доступность системы), они часто используют длинные придаточные предложения наподобие 'how the system is available'. Этот курс исправляет такие привычки путем обучения номинализации.
Номинализация — превращение глаголов и прилагательных в существительные (например, от 'decide' к 'the decision to', или от 'available' к 'availability') — это краеугольный камень академического и формального технического стиля в английском языке. Правильное использование этого грамматического приема позволит вам звучать гораздо точнее, объективнее и авторитетнее перед международными клиентами и менеджментом.
На рабочем месте умение составлять понятный 'Request for Comments' (RFC) и объединять стейкхолдеров вокруг дизайнерского решения существенно сократит время, необходимое для получения одобрений (sign-off). Вместо бесконечных дискуссий, где члены команды говорят о разном, вы сможете представить структурированные аргументы, способствуя развитию культуры сотрудничества на основе хорошо написанных технических документов.