Tầm quan trọng của Artifact/ Design Docs trong internship

Tác giả: Tien Duc Nguyen – Google AI Infrastructure Engineer

Mùa internship sắp tới, còn chỉ hơn 1 tháng nữa thôi. Mình cũng có nói chuyện coffee chat thì có 1 số bạn hỏi kinh nghiệm về internship. Coding (mình đang lấy ví dụ SWE) chỉ là 1 phần nhưng artifact là một phần rất quan trọng trong cả internship. Nhiều bạn nghĩ việc design docs chỉ dành cho mid-senior SWE nhưng sự thật là khi bạn note down thì bạn sẽ dễ dàng excel expectation cho những host của bạn.

Ví dụ nhé, một bạn làm internship, coding siêu nhiều, nhưng khi được xét lại Return Offer thì những người không liên quan đến team bạn (thường là HR) sẽ đọc lại những việc bạn làm và đa số chỉ là code hoặc là những artifact mà bạn viết cho bản thân bạn hoặc coworker trong team. Nó khiến cho project của bạn bị devalue trong khi được xét duyệt Return Offer, dù bạn có tăng 100% efficiency nhưng người ngoài team là người xét thì cũng khó cho bạn được value hơn so với những người đồng lứa khác 

Các bạn nên nhớ là người xét cho impact của dự án là những người level cao hơn (như là manager) cho đến HR nên họ hầu như không có nhiều context cho những dự án của bạn. Việc tạo design docs nó có rất nhiều lợi ích (nếu mình làm host mình sẽ có ấn tượng mạnh mẽ khi biết một intern làm được nhiều thứ như vậy):

• Design docs chứng minh bạn làm việc chuyên nghiệp, “think first, code later” là câu nói mà mình khá thích từ intern host năm 2 của mình
• Design docs/artifact khiến bạn tạo 1 dấu ấn lâu dài: Code có thể đổi nhưng documentation thì không, thậm chí nó còn dùng để làm reference trong những dự án lớn (Ví dụ điển hình là docs của mình vào năm 2 vẫn được hỏi lại vừa rồi để họ làm reference cho dự án lớn)
• Design docs giúp nâng cao khả năng giao tiếp và trình bày ý tưởng: Giao tiếp với coworker ý tưởng qua design docs và dùng design docs để lead những cuộc conversation sẽ luôn là lựa chọn hàng đầu và chứng minh bạn là 1 intern “chuyên nghiệp”
• Design docs dễ dàng track progress: Mình hay não cá vàng nên mình dùng design docs để track những process, bug nhỏ khác nhau

Có nhiều loại artifacts mà 1 intern có thể làm:

• Design docs/Technical Specs: Thường thì docs này sẽ do những người mid-senior làm nhưng nếu bạn có “cơ hội” tìm thấy khi old design docs bị sai hướng, thì bạn nên cố gắng đứng ra viết lại (đó là cơ hội mình tìm được vào internship năm 3)
• Project Planning: Breakdown công việc, timeline và các milestone. Những skill này sẽ giúp cho những người intern host thoải mái hơn để hiểu bạn làm tới đâu bất cứ khi nào họ cần
• Weekly Update: Thói quen note down trong cuộc meeting là 1 skill thể hiện sự chỉnh chu khi làm việc, các bạn có thể xin phép trước rồi note down để dễ hơn
• Post-mortem: Phân tích những impact sau khi hoàn thành 1 feature lớn hoặc fix một bug quan trọng (mình từng kiếm được 1 P0 bug trong khi đi làm thì được sếp khen do viết lại bug đó và note down impact)
• Knowledge Transfer Doc: Docs này khá quan trọng vì nó là tổng hợp những docs trên và những người không biết về context sẽ dễ hiểu hơn về impact của project của các bạn

Mình nghĩ mình nói hơi nhiều (mình thường nghĩ vậy ) nhưng đây là những tips mà mình có thể được consider là excel expectation trong internship năm 3 của mình ở Google. Chúc các bạn một ngày tốt lành