Taro Logo
Profile picture

Communication Q&A and Videos

About Communication

At the end of the day, working in tech, or anywhere really, is all about working with other human beings. Communication is the core skill necessary to make this collaboration effective.

How to write wiki type documents effectively?

Mid-Level Software Engineer [SDE 2] at Amazon profile pic
Mid-Level Software Engineer [SDE 2] at Amazon

Background:

Being pressured to deliver at high speed all the time, my team doesn't seem to value wiki type documentation a lot.

When starting a project/feature, we often have a high level design doc & design meeting to talk about high level infrastructure, and we make key trade-off decisions together as a team. If we are lucky, we get another low level design doc & meeting focused on sequencing of actions & interaction between class level objects.

We rarely seem to go back to our initial design doc after initial design phase of a project to update them and explain the actual final product we built and maybe some additional design decisions we made during implementation.

As a result, documentations are kind of dead after facilitating the initial design review. For legacy projects, high quality docs are extremely hard to come by and most just rely on reading large amount of code to understand how things work (nothing wrong with this but I think high quality documentation can save lots of time here).

I understand we don't want to boil the ocean and write everything in painstaking details, but we should at least have enough to help people understand responsibility of services and contract between them.

Questions:

  • Could you share your view on this topic and how you find your balance?
  • Do you believe it's always worth it to go back to documenting after finishing a project/feature and update it as if you are explaining it to someone new to the team/project?
  • Could you share any resources we might already have on this topic as well?
Show more
181 Views
3 Comments

How to talk to my manager about switching companies?

Mid-Level Software Engineer at Taro Community profile pic
Mid-Level Software Engineer at Taro Community

I joined company A in October (prior to which I did a contract job at company C for 1 month) but I already had an offer from company B which was delayed and joining was pushed to Dec. Now, I need to inform my manager at company A that I have to leave the company. It breaks my heart because all we have been doing so far is kind of training and stuff and no active work however, I do not like the kind of work I would be doing here as it is more like a Salesforce developer/ tester with the development outsourced and they are building a team to bring development inhouse. So even though the company is quite stable and has good benefits I have decided to leave it for a better paying role that I feel will satiate my career aspirations. Here are a few questions I am seeking answers for:

  1. The company has a Winter break starting Dec 22 and my manager goes on leave from 20, when should I break this news to him? (In my last company I informed my employer with a two week notice and I was given the last date to be just a week later. I am a foreign student in USA who has just started working and utilized almost half the number of unemployment days I have for this year to be precise 2 July, 2024)
  2. How should I tell him about this decision without burning the bridges. Honestly, I have this feeling that I am kind of cheating my employer so I am finding it difficult to justify it in front of my manager.

Thanks in advance!

Show more
115 Views
5 Comments

How to influence engineers to hold up their timelines?

Senior Software Engineer at Taro Community profile pic
Senior Software Engineer at Taro Community

I'm an E5 iOS at a Big Tech company reporting to an M2. I'm leading the mobile side for a multi-quarter product project that leverages work from 2 platform teams. Most of the complexity of this project will be on the mobile side. My backend lead is an E6 full-stack web engineer reporting to an M1 who reports to my M2. The M1 is on parental leave until late Dec / early Jan. This E6 has been an amazing partner and teammate.

The 2 platform teams have missed a lot of their timelines. One dependency is about a month behind schedule. They often give us deliverables that are dev-complete and not tested (e.g., compilation errors, etc.). We have sync meetings 2x/week, but 1 platform team has never attended any of these meetings. The other platform team doesn't always send the same engineers to the meeting and doesn't always know the status of their own deliverables. That platform team's EM got terminated for performance reasons before this project started, so their M2 and a TPM have been tag-teaming to fill in the gap. That means sometimes their M2 attends the sync meetings, sometimes the TPM attends, sometimes both attend, and sometimes neither attends. The TPM sends a weather report on that team's deliverables every other week, but hasn't sent one in the past month. In his last email, he listed my E6 and me as the DRIs for their team's deliverables. When I confronted him about it, he said it was a mistake and he'll fix it in future emails. How do I bring visibility into these delays to external stakeholders?

I created a shared Google Doc to track all the dependencies, including when our team needs the deliverables, the other team's ETAs, and any notes. However, it's been challenging getting ETAs from the other teams. When I tagged them in the Google doc asking for ETAs, they just ignore me.

My manager gave me feedback to "influence engineers to hold up their timeline than push for hard commitments". Do you have any concrete advice here? I'm not sure how to do this.

After I escalated the 1st platform team's unresponsiveness to their Director (3 levels up), the E6 iOS DRI became very responsive. Escalating to that E6's skip level had not been effective. Should I just keep escalating everything or is there a better approach?

Show more
63 Views
3 Comments

How to communicate with HR and EM when they didn't include for the appraisal/promotion cycle?

Mid-Level Software Engineer at Taro Community profile pic
Mid-Level Software Engineer at Taro Community

Hey there, for context, I completed my first year as Software Engineer.

I joined the company because I was in dire need without checking the company culture, following which I was not satisfied with the designation. I then started to look out for a job.

I got that offer after 4 months of joining with 33% increase in the salary.

When I told my EM he was willing to talk to the HR and match the salary but then the Head of the department didn't promote my role in the light that others in the team will think and ask why in 4 months I got my role upgraded.

The leadership conveyed that I might get the designation in the 6 months appraisal cycle.
In the appraisal cycle they denied my promotion saying my salary doesn't match the orgs designation and they don't know what to do.

I was not happy with the decision and since I didn't had any offers I kept working for the organisation hoping I will get it in the 1 year cycle.

Now I didn't get the review form for 1 year appraisal cycle. I think they will say in the lines of because your salary was revised at the 4 month you are not eligible for this cycle.

Though I don't feel my designation is the right one. But I have some other responsibilities as well like family, commute etc. I'm losing my motivation.

I need help in crafting effectively to EM and HR so that they consider my role and some appraisal so that they inline my career in the organisation else juniors will have a higher role in front of me.

From today I have also started looking out for other jobs, but I don't want to hurry in making decisions.

Show more
87 Views
4 Comments