DevOps Zone is brought to you in partnership with:

Mark is a graph advocate and field engineer for Neo Technology, the company behind the Neo4j graph database. As a field engineer, Mark helps customers embrace graph data and Neo4j building sophisticated solutions to challenging data problems. When he's not with customers Mark is a developer on Neo4j and writes his experiences of being a graphista on a popular blog at He tweets at @markhneedham. Mark is a DZone MVB and is not an employee of DZone and has posted 553 posts at DZone. You can read more from them at their website. View Full User Profile

Onboarding: Sketch the Landscape

  • submit to reddit

For four months during 2012 I was working on the GDS infrastructure team and one of the first tasks that Gareth suggested I do was update a diagram showing how all the different applications and databases worked together.

I thought this was quite a strange thing to ask the ‘new guy’ to do since I obviously knew nothing at all about how anything worked but he told me that was partly why he wanted me to do it.

I had to go through the puppet and application repositories to work out what monitoring we already had in place, which applications used MongoDB, which used MySQL, which called each other and so on.

If anything didn’t make sense I could go and ask someone in one of the application teams and then add my new understanding to the diagram.

As micro services driven architectures become more and more popular it strikes me that this probably wouldn’t be a bad starting point for anyone new to a system.

When you’re new you don’t yet have the familiarisation that makes things ‘obvious’ so you’re less likely to skip over things and more likely to be inquisitive about why things are the way they are.

As you come across things that don’t make sense others who have worked there for longer can play the role of the shaman who explains the history and context behind the decisions which have led to the current state.

Although diagrams can quickly go out of date I still think one of the whole landscape is useful as it gives everyone a common point of reference which can help reduce misunderstandings.

Pat Kua has a bunch of articles covering various different onboarding activities which are probably worth a read if this is your type of thing.

Published at DZone with permission of Mark Needham, author and DZone MVB. (source)

(Note: Opinions expressed in this article and its replies are the opinions of their respective authors and not those of DZone, Inc.)