Every month a small group of new engineers joins the company, and on their second day someone gives them an hour on how the platform fits together. The person who usually does it has moved to another team. Your manager asks whether you would take it over, starting next Wednesday. You say yes, and then you start worrying. There are parts of the platform you have never touched, and some of these people may be more experienced than you.
Here is the first thing to remember. You are not being asked to know everything. You are being asked to give new people a map, and you have something they badly need. You were new here recently enough to remember what confused you.
So start there. Write down the five questions you had in your first two weeks. Where does a request go after it reaches the load balancer? Which services own which data? Where do the logs live? Who do I ask about deployments? What will break if I get something wrong? Build the hour around answering those, not around covering every system.
Draw one picture and keep it on screen. Boxes for the main services, arrows for how a typical request travels through them. Then follow one real request from the browser to the database and back, pointing at the picture as you go. People remember a journey far better than a list.
Leave out what they can look up. Every configuration option, the history of each service, the exceptions. Point them to where it is written down instead.
When someone asks a question you cannot answer, do not bluff. Say I do not know, but the payments team will, and here is their channel. That is a useful thing for a new starter to learn on their second day, and it costs you nothing.
Leave fifteen minutes at the end for questions, and save them in a shared document afterwards. The questions are the best guide to what next month's session should cover.
And ask for feedback, two short questions in a form. What was the most useful part? What is still confusing? By the third session you will have the best onboarding talk in the building.
– Asael Shinder
Top comments (0)