Easy Agile Podcast Ep.14 Rocking the Docs

"I loved having the space to talk about common interests - all things technical documentation & information architecture" - Henri Seymour
On this episode of The Easy Agile Podcast, tune in to hear Henri Seymour - Developer at Easy Agile speak with Matt Reiner - Customer Advocate at K15t.
Henri & Matt are talking all things technical documentation (we promise this episode is way more interesting than it sounds! 😉)
✏️ Considering technical documentation as a product
✏️ The value of well written documentation
✏️ Why you should be digitally decluttering often
✏️ Information architecture
So many golden nuggets in this episode!
Be sure to subscribe, enjoy the episode 🎧
Transcript
Henri Seymour:
Hi, everyone. This is the Easy Agile Podcast. We've got an episode today with Matt Reiner. I'm your host for today, Henri Seymour, developer at Easy Agile. And just before we start the podcast, I'd like to acknowledge the traditional Australians of the land on which I'm recording today, the Watiwati people of the Dharawal nation. Pay respect to elders past, present, and emerging, and extend that respect to any Aboriginal or Torres Strait Islander people listening to this episode.
Matt is an experienced content strategist with a history of working in the computer software industry, skilled in agile scrum framework, related tools, communication, technical writing, video production, customer interaction, strategic planning. And he's here today to talk with us about writing and specifically technical writing and documentation. Hi, Matt.
Matt Reiner:
Hi. It's great to be here. Yeah, I'm Matt. I'm into all sorts of content things. And one of those is technical writing, which is, I think more interesting than it sounds. I guess you'll have to decide by the end of the podcast, if you think so.
Henri Seymour:
Technical documentation experts. So when you talk about technical documentation specifically, what do you mean by that?
Matt Reiner:
Well, I feel like that term is actually in the middle of a big change right now. In the past, technical documentation was very strictly like, "Okay, we're a team, we're making a thing, a product." Maybe it's an app, maybe it's, I don't know, a go-kart and we need to have a user manual for that. Technical documentation was someone sitting down and writing down, "Okay, here are all the knobs and switches and here's what they do. Here are all the features. Here's maybe why you would use them."
So putting together that user guide, which traditionally was printed material that you would get with the product. But it's become a lot more over time, partially with the internet, because we can just constantly iterate on content like many of us do with the products that our teams make. And then also we are seeing it in new forms. Maybe it's not a printed piece, in fact, most people do not want printed technical documentation anymore, they want it online. Or even better, they want it right in context in your app when they're using it, they can just get the info they need, and then get on with it.
That's what technical documentation is. It's supposed to be there to help you do the thing that you really care about and then get out of the way so that you can do it.
Henri Seymour:
Do you have a description of why good technical documentation? Not just having it, but having it at a good quality in a way that really helps your users, is so important to product users.
Matt Reiner:
Well, I suppose we all find those points in our day or in our journey that we find ourselves in where we want to accomplish something, but we don't know how to do it. So a lot of us have really gotten very used to jumping on Google and saying, "Okay, here's this thing I want to do, how do I do it?" And good technical documentation is there with the answer you need, the explanation you need. Because really ultimately all of us are smart people who should be empowered to do the thing we're passionate about.
And technical writers and communicators who are really all members of our team. People who sit down to create good technical documentation uses few words as possible to get a person on the way they're going. And that's like, when it happens its just like, "Glorious," not to the user. They don't even know that it happened, they didn't even know that they read your writing. But to the writer, it's like, "Yeah, I did it, I did it. They don't even care what I did, but I did it." And now they're doing the thing that really matters.
Henri Seymour:
That's great understanding one of the major differences of like, I've written something and I don't want my user to be spending time on it. I want as little time spent reading this as possible.
Matt Reiner:
Yeah, yeah, yeah. You can have great pride in your work, but one of those metrics that a lot of people look at for websites is time spent on page. So sometimes you can fool yourself into thinking, "Oh wow, they spent 10 minutes on my page. That means my documentation's really good." But also that might mean that it's not very good and they're having to reread it over and over again. So the true metric is, did they get to the thing they really cared about? And unfortunately, it's hard to measure.
Henri Seymour:
You mentioned now that with the advent of the internet and giving you the opportunity to iterate on those docs in a way that you wouldn't be able to with printed documentation. That iterative thing brings the agile process of iterate on something that you already put out and improve it in the same way that as a developer I do for products. Can you tell us more about that iterative agile sort of process?
Matt Reiner:
Oh yeah. Yeah, it's so true. Documentation used to be back in the waterfall standard, more typical product project management days, documentation was a major part of it. You'd start this project by writing these massive documents of, "Here's what we're going to set out to do. And here's all the considerations, and here's how everything's going to connect up." And that did work really well for a lot of hardware. Which was the thing that we made for a long time. Just everything that humankind made was hardware often, as groups anyway.
And then all of a sudden this whole software thing comes along and we're trying to build that like it's a physical thing. And we get to the end of this two-year software project and people are like, "Yeah, that's not the thing that I wanted." But we're like, "Oh, but we go back to the beginning and look at that documentation, and that's what you said you wanted." But now with the internet and with just agile development, we really need to move away from this place where we start with a pile of documents. And then we develop another pile of documents as our, I don't know, development guidelines.
And then our test plans, and then finally we end up with user documentation. Instead, these days, documentation should really just grow from a very small piece of content throughout that whole agile development cycle into that final user documentation. Because it doesn't matter what we set out to make, it matters what we make. Nobody he wants to read about what we thought we would make, that's straight up fiction. And it's probably not an interesting read. It's really that final user guide that comes out of the agile process, but that's a big change, but it's a good one.
Henri Seymour:
I love that idea of just like, this is gradually growing. There is no specific start block and end block. It's a process. And you mentioned the opportunity to iterate on those documents. Do you have any advice for after you've published digitally your technical documentation from iterating on what you've already got there, improving that over time?
Matt Reiner:
Oh yeah. I know every agile framework is different, but they all have that feedback phase, where... And really that's throughout the whole process, but we do need to dedicate some time. So, there's a lot of different things we can look at. For example, I don't want to say basic, a standard one that we should be looking at is, you should have a help center, where you can implement something like Google Analytics so you can see just, what are people looking at? How long are they looking at it?
Another really good one is, you have to set it up separately in Google Analytics. What are people searching for on your site? You can also use Google... used to be Webmaster Tools. I think it's called Site Tools now, but you can see what were people searching for on Google before they came to your pages. That's all really, really valuable stuff. Then you can get more advanced. You can look at pointer tracking, apps that you can embed on there, which you get some pretty wild stuff.
But then you also, you want to consider having a forum at the bottom of each page like, "Was this helpful? Was it not helpful? Oh, it wasn't helpful? Tell me why. Oh, it was helpful? Tell me why." Just like a YouTube creator, they look for that feedback. That feedback is essential, the thumbs up. In fact, it's very controversial, YouTube just announced that they're going to hide the thumbs down numbers, but a lot of creators are like, "No, no, no don't do that because that communicates the value of this video that is out there."
So there's a lot of those signals. And then there's just really soft signals that, it's hard to know if people are using the content or not. Because you may never hear. Especially, if it is one of those things that they just get in and get out, you're not going to hear anything about that. But the feedback phase, it's really great to... Anytime you're getting feedback on your product that you're making, try to get your documentation out there as well. Because that's the time where people are open to exploring your product and giving feedback.
So why not explore that same documentation, the related documentation to see, "Okay, is this actually helping these people do the thing that they want to do? Or should we improve it just like we do with the product?"
Henri Seymour:
No, that's a really good, comparing the, we've just released a product. Give us feedback with doing the same thing with the documentation. Because that's when it's going to reach its peak use before everyone's got the hang of it. We've just done this feature release, let us know how you go using it, and the documentation is in a sense part of it, especially for more complex products.
Matt Reiner:
Exactly.
Henri Seymour:
Do you have any background in the customer support side of things? We do customer support in-house as well as their documentation. So we're trying to improve the documentation to lower the support load on our team. Do you have any background in that... Can you solve it?
Matt Reiner:
Yeah. Well, yes and no. It's interesting. I work at K15t now, I used to be a customer of K15t's, so that's actually how I met the team. And that was also how I met documentation in the first place. At my last job, they brought me in to administrate this system called Jira. And I was like, "I don't know what that is." I told them, "I thought I could do it." And I figured it out, it was this little thing called Jira On-Demand, which is now Jira Cloud. And I introduced Confluence On-Demand to the company as well. And wow, I broke Jira a lot of times.
Luckily it wasn't like mission critical at the time, we were still really figuring it out. But it was through Atlassian's documentation on Jira that I really learned like, "Wow, there is tremendous value to this content here." And then I discovered, "Okay, how is Atlassian creating their documentation? Oh, they're doing it in Confluence. They're writing it in Confluence. They're using these apps from K15t." And so I started using those apps, and then I talked a lot to K15t customer support, just questions and how do I get this started?
And we also do our support in-house, so it's really great. So maybe as a customer, I overused it, I don't know. I should ask some of my colleagues if they got sick of me. But the benefit was very clear because they would send me, "Oh, here's documentation on this. And here's the answer to this question or here are the considerations you should keep in mind." And actually several of our teams now, we're really looking at, especially, for those features that are very robust, people have questions.
So it's like, how can we enable them to help them help themselves? And putting those resources out there is one thing, making sure that Google can find them, well, is another. But that is a really important thing, especially, since as a product team, when your user base grows, so does your need for support. It's just... I don't want to say it's exponential, but it's in line with each other. And so, one of the ways you can mitigate that is, making sure you have good design so that your product is easy to use. And then another is you need to have good content all around that entire experience so that you don't have to keep hiring more and more support people.
Or your support people can specialize and really focus on those deep entrenched issues, and then the documentation should help with the rest. But the secret sauce there is tricky. It's hard to write the perfect content to deflect the cases. That's everybody's dream.
Henri Seymour:
Even if it is just not all of them, but some of the common use cases start to get deflected away from support because people can self service. It does make a difference. And I really understand the idea of Jira documentation as well. Easy Agile works on Jira and it's... Jira is an incredibly complicated product at this point, and I imagine it probably was also complicated when it was Jira On-Demand. Because it's so complicated and so detailed, there's no way to make that easy to understand for a user without that documentation. There's no getting around that one.
Matt Reiner:
Yeah. I think there should be a club for the people who have broken workflows too many times in Jira. But yeah, I mean the documentation saved me many times and I would have to put out a... Well, it was a HipChat message at the time. May it rest in peace and I'd have to say, "I broke Jira, give me a minute. I got to go read something." Not the way you want to learn Jira, but it's an option.
Henri Seymour:
It is. Sometimes you learn things by breaking things. That's-
Matt Reiner:
That's right.
Henri Seymour:
Really seems like my experience in software so far. You try to break the things that people aren't currently using and that's about all you can do.
Matt Reiner:
Exactly.
Henri Seymour:
So K15t has recently published Rock the Docs. Can you tell us a bit more about this project?
Matt Reiner:
Yeah. Rock the Docs, actually, it came out of a lot of that information that I got from K15t. Customer support, I got from K15t documentation, I got from Atlassian documentation. And then some of the stuff I figured out on my own, or some of my colleagues at K15t did. Essentially like, what are the best practices for creating really good content in Confluence? And it really started with a collection of guides on how to create technical documentation content. It's geared toward like making a public help center, but really it's for any kind of content that you want to be like evergreen, longstanding content to be able to help people.
So we initially talked about all sorts of things like structuring your content, content reuse, managing multiple languages, which can be tricky in Confluence. Collaboration, publishing your content outside of Confluence in one way or another, managing versions of that content. So, that's the start of it. And then we saw a lot of positive response with that and we had more general questions like, "Okay, but what are the best ways to get feedback in Confluence?" Or, "How do I make a template or a good template or how do I make a good diagram in Confluence?"
And so we've grown that content to focus on just all sorts of general Confluence things. Because we found that there's a lot of information out there on how to do something. Atlassian documentation really helpful, but there wasn't as much, I'm like, "Why would you do it? And why would you do it this specific way?" And we've been working with Confluence for over 10 years now. Like I said, I've been with Confluence since the crashy early cloud days. It's grown up so fast, it's beautiful.
But we just know we've done a lot of stuff with Confluence, so it's been a real privilege to share that both in like these written guides. And then actually recently we've started publishing a series to our YouTube channel as well, all about Confluence best practices.
Henri Seymour:
That's great. It's real interesting to hear how that started as a smaller project than it turned out to be, because you could see the value in it and the use in it. We've discussed Confluence a few times now and K15t builds apps that use Confluence as a documentation source. Can you tell us more about what makes Confluence useful for building technical documentation? What sort of tools and approaches that make it useful in this context?
Matt Reiner:
Yeah. Confluence is by nature open, which is not the way technical writing tools are built. In fact, I remember the first time I went to a technical writing conference and someone asked me, "Oh, what tool do you use?" Which is like, what technical communications people talk about, because we're all nerds in that way. And I was like, "Oh, I'm doing it in Confluence." And they didn't really want to talk to me after that because they didn't think I was a serious tech writer. And I was like, "Oh no, no, no, no, this is all happening."
At that point, Rock the Docs didn't exist. So I couldn't be like, "Go over there and see how it works." But the biggest difference is most tech writing tools are just totally locked down. You have two licenses for your two people who are trained professional tech graders, and then everybody else, there's no access. You don't touch it. Maybe your tech writers will send you a PDF and you have to go through the God awful process of marking up a PDF to tell them like what to correct. Or, I've heard of teams printing out the content and people penciling in what needs to be changed.
The review processes are just out of this world insane. And those tools don't fit terribly well with agile processes because it's like, you build the thing over here, and then here's the two tech writers over here in their separate tool. And at some point we'll be like, "Okay, this thing's done. Would you write about it?" So with Confluence, the benefit of using Confluence is, it's accessible to everyone on the team and even people outside the team. And that's incredibly by an official because we've seen with agile, but we're also seeing in this technical communication and in information design field, that teams are less and less looking for those specialized individuals who are trained tech writers.
Which that's an oxymoron because half of us, we don't have degrees in tech writing, we fell into it for one reason or another. But now teams are starting to see, "Hey, I can be a code developer and an information developer. I might not write the final piece of written content that is seen by our customers, but I might write the first draft." Confluence really opens that up for everyone. And especially with like at mentioning and inline comments, review processes are just so fast.
Actually, the reason that I switched to Confluence at my last job, was my product manager threatened me and said, "I will not mark up another PDF. Go and find a good tool that we all want to work in." And that's where we landed on Confluence. It's about bringing the whole team into the writing process instead of having it be this separate thing. Because when it's a separate thing, we lose track of it. And content, we forget how important it is to our product, to the customer life cycle, to... God bless customer support, who really, really need that content to be good and accurate.
And it needs to be seen by the real experts who validate, "Yeah, okay, this is correct. This will actually show people how our product works." And Confluence is like the heart of that.
Henri Seymour:
No, it's great to hear how that all comes together to build the documentation as a team. Can you speak more to the different roles in, specifically in software development and the different roles you're looking to get involved in your documentation process? We are working on building our specific app teams here at Easy Agile as we're growing at the moment.
Matt Reiner:
Yeah. That's such a good question. Well, what-
Henri Seymour:
And how do you incorporate... Sorry, this is more specific to my question. How do you incorporate that technical writing process as part of the work of an agile software development team?
Matt Reiner:
Well, first, it starts by rethinking priorities because most teams are like, "Documentation down here, testing and then everything else above." So generally, those two things should be moved up. And actually, the content around our product is... I don't want to sound over traumatic, but if we don't have information, we don't have a product. I don't care how much code you write. If we're not explaining it to people, if we don't have good UI text, if we don't have good in-app help, it doesn't exist. It's not a useful tool, it's just a set of mathematics that humans can't interact with.
So content is essential, so it's really important that we elevate it to the position where everyone on the team recognizes that the content experience that our users have is the product experience they have. So it needs to be part of the product development process. So then the next step, which I know you're talking about team structure, but the next step is really everyone on the team needs to know they're a writer, and they're a good writer. And that's important because a lot of people have never heard that. They've never heard that they're a good writer, and they probably have never heard that they're a writer.
I remember going through university, my writing classes were the things that I didn't pay attention to. I was doing mathematics, and Java programming, and statistics. Even that seemed more important to me, not the writing classes. And then sure enough, it turns out everyone has to write. We all write. So knowing that that is a role that everyone fills is really important. And then when it comes to actually team structure, you need to have individuals who are willing to cross the streams, so to speak. If you're bringing in someone who's focusing on test engineering, they need to realize that the test plans they're writing are very similar to a lot of user documentation that needs to be written.
They're writing task topics, or task instructions, do this, do this, do this over and over again. That's documentation. They could be contributing in that way. Engineers, as I mentioned, they could be drafting the first copy of a lot of what are called concept topics. So areas of documentation where you explain concepts, because they already know what those concepts are. In fact, if you look at the root of a lot of agile development teams, they're using epics and user stories and acceptance criteria. And all those map perfectly into the documentation you needed to create for that new feature you're working on or feature you're improving.
So really, it's essential to have everybody recognize, we are all already creating documentation, so we can contribute. And then of course, you really do want to have at least one probably native English speaker. Maybe not native, but someone who feels confident in their English or whatever language you're authoring in. English is typically the cheapest one to translate to other languages, so that's what people go for often. But that person's the person who takes everything everybody's written, gets it to the right style and tone. And then gets it out there. That's what we are seeing be successful.
Like our teams right now, we don't have any legit tech writers. We have product managers writing. We have product marketers writing. We have engineers writing. Some of the best documentation I've ever read was from one of our German-speaking engineers. I was like, "Peter, this is an amazing guide. You got to get out of this Java and get into English, man. It's great. It's great." So he's done a few, which I really love. But yeah, it's about jumping out of your typical roles and realizing, we're all documenting this stuff, anyway.
Henri Seymour:
I love the focus, especially with your German-speaking colleague. The focus on, it's not just that you must write the documentation because you know how the product works and we need that written down. It's, you are capable of writing the documentation, you can do this. You have that added barrier of safety with somebody who's got the language proficiency that they're going to massage it and edit it at the end.
So, before it gets anywhere, anything that you do is going to get filtered out if it's not working. But you don't need a specific tech-writing background to write the docs.
Matt Reiner:
No, absolutely not. In fact, there's an entire community of what... They call themselves documentarians called Write the Docs. And that whole community, that whole group is focused on, it doesn't matter what you do, it matters that you care about writing the docs, contributing to the content. And that's been a big shift, I think in the industry, where people thought we're separate. But now it's like, "No, no, no, we are all able to do this." And once we can respect the contributions that each of us can make.
And then also, I have that protection of somebody else is going to have their eyes on this, which even my writing, I'm like, "I don't like to send it out until someone else has seen it." Because I make spelling mistakes and typos all the time. I really want to have another colleague look at it. Even if they're not native English speakers, because they catch my typos pretty often. That feeling of togetherness, it's the same way that we feel when we ship out a project or a product.
Whether you did the testing for it, or you wrote the code for it, or you did the product marketing for it. It's like, "It's our baby. Let's send it out and see what happens." Content's the same way.
Henri Seymour:
Yeah, part of my daily role and [inaudible 00:28:03]... We don't have QA team separate from developers. Our developers also review our code and it's that sense of, "I wrote this thing, but I have one or two other people who've refined it, who've made sure that it's good enough quality. They've got that fresh eye, so they'll see the spelling mistakes, they'll see the minor little errors that I've just been looking at it too long to notice anymore."
I found the documentation writing process has some parallels in there like, "Here's my thing. I'd like some feedback on it before it goes out into the real world."
Matt Reiner:
Yeah.
Henri Seymour:
That's great.
Matt Reiner:
Yeah, absolutely. Yeah.
Henri Seymour:
All right. Can you talk a bit about the difference between the customer-facing documentation that we've mostly discussed so far and internal documentation?
Matt Reiner:
Yeah. There are some differences and there are some major similarities. So this very... It sounds very technical and ugly. The term information architecture, it's really important with any kind of content, internally and externally. And really that's like, if you're a developer you're familiar with XML, you're familiar with structuring things in that way. Our content needs to work the same way. And that goes for internal and external documentation. So, many of the things that they use, writers, when they write a page or an article in the newspaper, they'll use that Pyramid approach, where they put the broad bits of information at the top. And then they slowly focus in on the topic and give more and more information about it.
But you want to make sure that if somebody only reads the first paragraph, they're getting a rough idea of what the information is. And that's really important for successful Confluence pages and spaces. People should be able to start at the top level of the space, understand what the space is about, and then be able to navigate down into the thing that they really want to learn about into the page itself. Which should then be using headings and subheadings and bullet points to get, again, just disseminate that information and break it down. Because everybody skims.
We need our content to be skimmable, our spaces need to be skimmable. And that kind of content also makes Confluence search happy, especially the new Confluence Cloud search, which has been greatly improved. There's a whole new elastic search base to that that's being optimized. But it's happy, it's just like with Google when we structure our content like that. So when you have a page that is just a wall of text, no headings, you're not breaking it up into pages or even spaces, nobody's going to be happy with that.
The bots aren't going to be happy with it, the people reading aren't going to be happy with it. So it takes a bit of work to structure, break up the structure of our content. It's probably all good as long as it's up-to-date, but it's really essential that we think about, how do we structure that in Confluence so that people can find it and people can skim it? And that is what seems to plague a lot of internal Confluence instances, because a lot of... Maybe the team isn't so focused on that.
It's like, "Oh, our external help center that's come coming from this space over here, that's fine. Our team space, hot mess, total tire fire." And nobody cares because they think they know where everything is. But then you start to think about, "Okay, but what about the new team member? How do they find something?" Or, "What about the team member who's been away for Paternity leave for six weeks? Are they going to remember where everything is or know where all the new stuff is?
What about folks with disabilities? Is it going to be much harder for them to navigate to the information they need? Because they're working with a screen reader and they're trying to go through a wall of text. They need headings, a screen reader relies on those headings and titles." So there's just so many considerations that really leadership of companies needs to understand, just because you have a process to do something or the information is somewhere, doesn't mean you don't have a major information problem. And maintaining all of your content in Confluence and then maintaining it well.
That is what enables people to avoid the frustrations of searching for information, losing information, having to relearn or rewrite information. I have worked at too many companies that just information sieves everywhere. I don't even want to call them silos because nobody knows where stuff is anymore either. That's what Confluence brings to things, and that's what matters with internal content pretty much as well as external.
Henri Seymour:
That's a great perspective on it. And I can see the silos, it's a really more... Just a one big pile, you can't find anything. I've been-
Matt Reiner:
Exactly.
Henri Seymour:
... at Easy Agile for more than half of its life now and I've got that sense of like, "Oh, I know I wrote this down somewhere. I know I've seen this written down somewhere." And we are making a habit, especially as we're hiring more and more people. Every time somebody's going through onboarding, they're going to be looking at all of this documentation with no previous background on it. And we want to hear their feedback on it specifically. Because if it works for them, then that's the documentation that we need for them and for everyone after them, and for everyone who's already here.
Especially, I've been at Easy Agile for almost three years now, and I've seen it grow from eight people to now we're up to high 20s, I think. We're going to cross over into the 30s by the end of the year.
Matt Reiner:
Wow.
Henri Seymour:
The growth of information that we have in our internal documentation, and I'm sure it would parallel the growth of the product documentation for a product that's been expanding for three to five years. How do you manage the documentation and the Confluence spaces as the team and the company grow and you just develop more and more pages out of it?
Matt Reiner:
That is the question since the dawn of the universe or at least the dawn of Confluence, which, what's the difference? The biggest thing is team responsibility, so knowing this is our space, this is our content. And not like in a territorial way, but this is our responsibility. Much the way we should think about our planet, we should also think about our content, keeping it groomed and taken care of, and up-to-date and accurate. And then as things change.
For example, we have a product called Scroll Viewport, which is actually what enables you to publish content from Confluence to a public health center, which is really, really cool. So with that, we had a server and data center version. We've had that for quite some time. That's what I was a user of. And then we set off to develop a cloud version, and cloud requires a whole bunch of new infrastructure, which is a lot of fun and very challenging, but it's a totally different beast.
It's not like you can just lift the server code and just drop it into cloud, which is what as a user I asked them to do for years, "why isn't this on cloud?" Now I know why. So we created a new team that started off this Scroll Viewport on cloud effort. And it was just a very scrappy project at first. And I remember the first page we got up there, it's like, "Whoa, look at this page we published." And then it progressed from there. But then at some point, we needed to bring the two teams back together. And what we could have just said, "Oh, this old Viewport space, whatever. We're just going to leave it there and then just go on with the new one."
But instead the team took time and brought the two spaces together and really went through the old content in the Viewport Server and data center space to say, "Is this all still relevant? Do we still need this?" So it's been reordered in such an amazing way. Several of our teams have gotten really good at making these spaces so that I can come in. Because I work with all of our teams, just get in and find what I need, even though I'm not working their day-to-day. I'm just so glad, I'm so proud of the team for not just letting that space languish somewhere or being afraid to delete or archive content, which a lot of people are.
It's like, "No, what if we lose something?" It's like, "No, no, no, we've moved past this. We really do need to delete it." So that's the kind of attitude it takes is, our teams to split and expand and grow, and we need conscious of that content. Because again, think of the new person, think of the person who's learning something new. Think of the person who maybe does have disabilities and is trying to get the content they need. They just don't have the background that you do. Having been with the company for half its life, you know how to dig through the thought pile to pull out just the thing you want, but they don't.
Henri Seymour:
Yeah, and I don't want to be the person that they have to ask every time they need information, "Hey, can you find this for me?" No, no. I want to build a system that means that I don't have to answer the same questions all the time. That's one of the reasons I've been doing internal documentation so much since [inaudible 00:37:36]. I've answered this question once, that will do.
Matt Reiner:
Yes. That's a really good way to motivate any contributors to documentation. "Hey, you know how you wrote that piece of our app that one time and then everybody's asked you about how it works ever since? Just document it once and I promise you can never answer it again." That's good motivation right there.
Henri Seymour:
It is. As well, we've got a team on support models, so I'm working on the store maps and personas, product development team. And that's the same team that gets all of the support requests about story maps and personas. So yeah, the better we make the product, the better we make the documentation, the less of our time every morning we spend doing that. And the more we can get back to our regular jobs.
Matt Reiner:
Exactly.
Henri Seymour:
It's been great for helping us keep in contact with the customers and what they're doing and what information they need when they're using our product. You mentioned that like it's necessary, it's valuable to be deleting an archive-based stuff, pages in Confluence from time to time. When you're looking at a page and wondering whether or not it's time to go, what sort of questions are you asking yourself?
Matt Reiner:
Well, a great one is like, look at the last modified date on that page. That's general a pretty good sign of like, "Are people even looking at it?" In fact, if you're on cloud premium and above, you can look at some great metrics on every page to see like who's looking at this thing? Is this valuable? What are the views like? Just the same way that you would look at your external website to see if your content is valuable or effective. But typically, we have a lot of debris left over from product development or team activities.
Like if you're in marketing and you have a campaign from three years ago, do you really need all of those detailed pages? Maybe keep the overall campaign page, maybe that's useful, but do you really need everything? If you're into testing, do you really need every test plan you ever created? If you're in the legal team, do you really want your legal terms from 10 years ago? Maybe, maybe, I'm not in legal. But often we have this fear of, it's like fear of missing content.
It's like, "Oh no, if I get rid of that, then I won't have it." But information, just like language, just like the way we think, just like the way our teams grow, it changes. And so we need to be aware of that. As we are changing as a team, you should expect our content to change. And part of that is shedding that old stuff. So it's always worth it, like if you're questioning it, ask another subject matter expert and be like, "Hey, I'm pretty sure we don't need this anymore, or we should revise this. What do you think?" But if nobody has any qualms, you should probably delete it.
Henri Seymour:
No, that's great. I am a big fan of decluttering, even digital decluttering. It's, I want people to find stuff and the less pile there is, the easier it's going to be.
Matt Reiner:
Yes. Because somehow bad information is less helpful than no information.
Henri Seymour:
Yes. It's like coming across a question and they're like, "Oh, I tried doing it this way." I'm like, "Oh, that way doesn't work anymore. You're going to have to do... Where did you find that written down? I'll go update out." It's-
Matt Reiner:
Yeah.
Henri Seymour:
... new people doing stuff. The best way to understand where your documentation is falling over. It's the same as you're never going to understand how your product documentation and that your product itself is failing your users until they come to you and tell you, "Why can't I do this thing?"
Matt Reiner:
Yeah. Yeah. In fact that that power of bringing in someone new on your team is so amazing. And it's almost hard to impart like first day of onboarding like, "You have fresh eyes, please use them. This is called an inline comment, please put it everywhere." I remember going through our human resources employee handbook, which we had just created not too long before I joined. And I remember them telling me, "If there's any questions, at mentioned us." And I was really afraid to do that. But we corrected a lot of things.
For example, we mentioned do these things on... What was it called after HipChat? The product that lived and died so quickly.
Henri Seymour:
I think I missed that one.
Matt Reiner:
Oh, the one that Atlassian made and then they sold it to Slack.
Henri Seymour:
Now, where do I even start on that?
Matt Reiner:
How am I... It was a great app, I really liked it. But we mentioned in the employee handbook to use that. And I'm like, "Oh, I think we're using Slack now, we should update this content." That's stuff that HR is never going to go through and catch, but your new employees can do that. New people are the best way to tell you if your processes are bad, if your content is better. Maybe not bad, but they're bringing in something new. That's why we added them to the team. And they should not be afraid from day one to ask questions, or poke holes in our already messed up or failing process.
Henri Seymour:
Yeah. And I can really see the benefit of the tools in Confluence, like that inline comment. Even if you don't know how you need that page updated or what the new version's supposed to be. It's just coming in fresh, you can go, "Oh, this is weird, or incomplete, or it might be wrong." It's just a little comment. You don't have to change it yourself, just say something. Here's a way to speak up without changing it yourself. And somebody who does know is going to be able to change it for you.
I was excited to hear you talk about information architecture. That's something I only got introduced to last year also. Do you have a general explanation of what information architecture is and why it's relevant to documentation?
Matt Reiner:
Oh, information architecture is, there are whole, people, professionals whose entire career is coming in and helping you. So I'm not one of those professionals, I just play one on TV. Really in essence, information architecture is breaking down what would be a wall of text into a pattern of information that anyone's mind can connect to. That's the real and ultimate goal, and that starts by just breaking up logical chunks. In fact, in a lot of pure technical writing, you break the content into tiny, tiny pieces, chunks or some technical communicators talk about atoms of information, really tiny pieces.
And then once you've broken that down and said, "These are separate pieces," then you assemble them together in an order that makes sense. In fact, you can also do really cool stuff with content reuse in Confluence, using include macros and the new Excerpt Include Macro is very cool in cloud, because you can do new stuff with that. But it's really about breaking apart all your content, figuring out what's the order of all of this? What's most important? What's more specific? What is important for everyone? What's important for just a few people?
And then just going down like you would with an XML structure or any other sort of hierarchy and tier that information using your spaces, your pages, your headings. And then finally bullets and paragraphs and that kind of thing.
Henri Seymour:
Thanks for getting that generally explained. Is there anything you want to mention in your work at the moment that you would be interested in getting readers onto?
Matt Reiner:
Yeah, totally. A major new effort for me, because I'm just this content explorer, I guess. I've done like technical content, I've written some marketing content. I started speaking, which I enjoy speaking. I got to speak in front of one live audience before... No, I guess a few, and then, the world's shut down for good reason. Because when you're breathing out on a bunch of people, you want to make sure that you're not potentially putting them at risk. So been doing a lot of virtual speaking.
But recently, I mentioned, we've worked on all these best practices on Rock the Docs. And so we've started this video series about Confluence best practices and it's been very exciting to figure out, "Okay, so I know how to create fairly good in Confluence, how to structure that content. Now, can we make a good video?" And it turns out, no, not at first. Made some pretty poor ones or ones that just took way too much time to make. And finally, as you do with any kind of content, we finally got a good structure, a good rhythm. And we also found what are those things people really want to hear about?
And so we've developed 16 of these now on our YouTube channel that are just out there for administrators to share with your users who are asking these questions. Or maybe these are for users directly who just want to subscribe and get these things. But it's like eight minutes of just as much information as we can pack and still speak fairly legible English. And then show just like how do you do this in Confluence? Why would you do this in Confluence? What are the things you should consider in Confluence? What are the best ways to do things in Confluence?
We've actually just started a series of live streams as well, where we're trying to look at those more in depth and then have people live listening in, asking questions and directing the whole thing. So far those have been really great and we're looking to do more of that. So the more people who pile into those, the more direction y'all get to give that content. But it's been new types of content that it's exciting to see, okay, our good written content in Confluence is coming to the real world in a new format. Which has been cool and challenging and fun and scary all at the same time.
Henri Seymour:
Yeah. That's sounds like a really exciting project. Rock the Docs is going audio-visual. And I can-
Matt Reiner:
That's right.
Henri Seymour:
... figure what... Get users on there to give you that iterative feedback that we talked about at the beginning. And so is this worth the thumbs up? Do you have comments? What else can we do? And especially in that sort of live stream webinar format, you get that direct contact with your users so you can find out what they're needing. That's that's fantastic. Probably see if I can come along with those. Easy Agile started using Scroll Viewport for cloud specifically earlier this year.
Matt Reiner:
Oh, cool. Oh, cool.
Henri Seymour:
So that's been a major improvement for us actually.
Matt Reiner:
Oh, good. Yeah. I'm just loving what the cloud team is putting out. It's so exciting and so polished and it's just like every team has that documentation space, and Viewport, it lets you put it out there and you're like, "Ah, looks so great. We're so proud of it." You can read it on any device. It's just like it's the magic that everybody wants, but no team has time. Our very few teams have time to make it look that good, so it's nice to have Viewport just do the heavy lifting.
Henri Seymour:
We've got the Confluence space, we've got the documentation. We don't have to make a website about it. It's just, "Go ahead, please make this website happen. Here's what we need on it. Here's the structure." And golly, it looks a lot better now, even just aesthetically, it looks a lot nice in the house.
Matt Reiner:
Yes. And it's nice to know that like some designer peered over the spacing between navigation items to decide how spaced out they should be. And as a writer, I can just like, I don't have to care. I don't have to care. I can throw in Confluence macros and stuff, and they just look really great when they're published. And I don't know how or why, but I'm happy. I can just keep writing. Yeah.
Henri Seymour:
Yeah.
Matt Reiner:
It would be great to have someone from Easy Agile join us for one of those live streams. Because what we're really focusing on is just like great way to do things in Confluence. We haven't jumped into Jira yet. I'm not as much of an expert in Jira, but I have thought about it because that content doesn't really exist yet. But it's not necessarily app-focused or K15t app-focused. It's just like one of the best ways you've found to do certain things in Confluence, and we're just sharing those with people alive, and it's a lot of fun.
Henri Seymour:
Yeah, that sounds great. I've got the parallel of get really into Jira and making Jira apps and Confluence is, "Yeah, we've got a Wiki. This is where we write stuff down." And it is great to have stuff like "There's the visuals on our docs page." But I don't do those. I'm busy making visuals in a Jira app. I don't want to think about that spacing. I've got my own spacing to do.
Matt Reiner:
Yeah. Yeah.
Henri Seymour:
And it really is that, I can just do the writing, I can just do product. I can do my job more because this other stuff taken care of because the experts at K15t have made that happen. And I hope that our apps can do a similar thing for their users of, this is the thing we need, we don't have to think about this. Bring in this app and it will solve a problem for us. It'll help us see what we need to and organize our information in Jira. Which is a different type of information again, but.
Matt Reiner:
Yeah, yeah. It's funny. I've talked with some people who have actually described that whole app part of Confluence in Jira as App Hell. That's a term that I've seen and I can't help but love the community because we all come up with this stuff. But app hell is, it really comes out of not understanding what a platform is partially. For example, if you're using the Salesforce platform, yeah, that's going to be app hell if you really want Salesforce to be a marketing platform. Because Salesforce is a sales platform. But then there's apps, and Salesforce happens to a sell big one. And then all of a sudden it's a marketing platform.
So that is a really interesting perspective shift for people who are used to a tool that just does one thing. Everybody thinks Excel does everything. It doesn't, we really should just use it for spreadsheets, everybody. It's not a platform for other things. Confluence is really good at these core things, Jira is really good at these core things. And then these apps, they come in to answer the questions that don't have answers and do the things that can't be done. And that's why. So is it App Hell or is it App Heaven? That's the real question. Or maybe it's maybe it's App Purgatory, I don't know. I guess the listeners gets to decide.
Henri Seymour:
The constant stream of, and yet another app needs to update. Which to be fair, I think is not a problem on cloud at this point. That's an exclusively an on-premise problem, the constant app update cycle. But we are hopefully moving towards the end of the purgatory perhaps.
Matt Reiner:
Yes. Yes. I think we're all ascending together. We're just reaching new heights all at the same time.
Henri Seymour:
Is there anything else you'd like to bring up while we talking tech docs?
Matt Reiner:
I guess, I typically go back to when I was in university, I had a manager there who told us in this on campus job that I had, "Our job is to connect people with the resources that are already around them. You're not a teacher, you're just here to connect people." And that has really stuck with me. And that is essentially what we all do. Whether we're building a product that connects people with resources or that is the resource or we're contributing to documentation or some kind of content.
We're really trying to enable people to do that greater thing, that higher level thing that is above our content, it's above our product. It's that thing that they truly care about and any part we get to play and that greater thing, that better thing. That's what it's all about.
Henri Seymour:
Yeah, that's really great perspective. That's probably also a really great thing to round off the end of the podcast with.
Matt Reiner:
I guess so.
Henri Seymour:
Yeah. Thank you very much for joining us, Matt, and for talking all things technical documentation with us on the Easy Agile Podcast.
Related Episodes
- Podcast
Easy Agile Podcast Ep.3 Melissa Reeve, VP Marketing at Scaled Agile

"I really enjoyed speaking with Melissa Reeve, VP of Marketing at Scaled Agile about how non-software teams are adopting a new way of working."
It's more important than ever to be customer-focused.
We talk about the danger of 'walk-up-work' and how to avoid this through proper sprint planning.
Melissa also gives an update on how agile is spreading to non-technical teams.
Transcript
Sean Blake:
Hello everyone. And welcome to the Easy Agile Podcast. We have a really interesting guest with us today. It's Melissa Reeve, the Vice President of Marketing at Scaled Agile. We're really excited to have her on today. Melissa Reeve is the Vice President of Marketing at Scaled Agile, Inc. In this role Melissa guides the marketing team, helping people better understand Scaled Agile, the Scaled Agile Framework. In other words, SAFe and its mission. She also serves as the practice lead for integrating SAFe practices into marketing environments. Melissa received her Bachelor of Arts degree from Washington University in St. Louis, and she currently resides in Boulder, Colorado with her husband, chickens, and dogs. Melissa, thanks so much for joining us on the podcast today.
Melissa Reeve:
It's such a pleasure to be here. I really appreciate it.
Sean Blake:
Great. That's great. I really like your enthusiasm straight off the bat. So what I'm really interested in hearing about, Melissa is a little bit about how you got to where you are today. What have been the highlights of your career so far and how as a marketer, did you find yourself in the Agile space?
Melissa Reeve:
Well, thanks for asking. And I have to tell you, but just before the podcast my husband knocked on the door and he was all proud because we just got a new set of chickens and one of the chickens had laid its first egg. So that's been the highlight of my day so far, not necessarily the highlight of my career.
Sean Blake:
So you'll be having scrambled eggs and eggs on toast probably for the next few weeks now.
Melissa Reeve:
I think so. So back to the career, I really fell into marketing. My background was in Japanese literature and language. And I had anticipated this great career and international business in Asia. And then I moved out to the Navajo Indian Reservation and just pivoted. Found my way into marketing and found my way into Agile right around 2013 when I discovered that there was an Agile marketing manifesto. And that really was a changing point in terms of how I thought about marketing. Because up until that point, it really considered marketing in what's termed waterfall. Of course, marketers generally don't use the term waterfall.
Melissa Reeve:
But then I started to think about marketing in a different way. And when I came across Scaled Agile, it brought together so many elements of my career. The lean thinking that I'd studied when I studied in Japan and the lean manufacturing, it was Agile marketing that I'd discovered in 2013 and just education and technology have always been part of my career. So I really consider myself fortunate to have found Scaled Agile and found myself in the midst of scaling Agile into both enterprises, as well as marketing parts of the enterprise.
Sean Blake:
Oh wow, okay. And I noticed from your LinkedIn profile, you worked at some universities and colleges in the past. And I assume some of the teams, the marketing teams you've worked in, in the past have been quite large. What were some of those structures that you used to work in, in those marketing teams? And what were some of the challenges you faced?
Melissa Reeve:
Yes, well, the largest company was Motorola. And that was pretty early on in my career. So I don't think I can recall exactly what that team structure is. But I think in terms of the impediments with marketing, approvals has always been an issue. No matter if you're talking about a smaller organization or a larger organization, it seems like things have to go up the chain, get signed off, and then they come back down for execution. And inherent in that are delays and wait states and basically waste in the system.
Sean Blake:
Right. So, what is Agile marketing then and how does it seek to try and solve some of those problems?
Melissa Reeve:
Well, I'm glad you asked because there's a lot of confusion in the market around Agile marketing. And I can't tell you how many news articles I've read that say marketing should be Agile. And they're really talking about lowercase Agile, meaning marketing should be more nimble or be more responsive. But they're not really talking about capital-A Agile marketing, which is a way of working that has principles and practices behind it. And so that's one aspect where there's confusion around Agile marketing.
Melissa Reeve:
And then another aspect is really how big of a circle you're talking about. In the software side when someone mentions Agile, they're really talking about a smaller team and depending on who you talk to, it could be anywhere from five to 11 people in that Agile team. And you're talking about a series of teams of that size. So when you're talking about Agile marketing, you could be talking about an individual team.
Melissa Reeve:
But some people, when they're talking about Agile marketing, they're talking about a transformation and transforming that entire marketing organization into an Agile way of working. And of course, in the SAFe world, we're really talking about those marketing teams that might be adjacent to a SAFe implementation. So, I think it's a good question to ask and a good question to ask up front when you're having a conversation about Agile marketing.
Sean Blake:
Okay. Okay. And for those people that don't know much about SAFe, can you just explain, what's the difference between just having a marketing team now working in a capital-A Agile way, and what's the difference between an organization that is starting to adopt Scaled Agile? What's the difference-
Melissa Reeve:
Sure.
Sean Blake:
...between those?
Melissa Reeve:
Yeah. So what software organizations found is that Agile teams, so those groups of five to 11 people, that way of working works really well when you have a limited number of software developers when you started to get into the world's largest organizations. So I think of anybody on the Global 2000, they might have tens of thousands of software developers in their organization. And in order to leverage the benefits of Agile, you needed to have cadence and synchronization, not only within a team, but across multiple teams up into the program level and even the portfolio level.
Melissa Reeve:
And the same holds true with large marketing organizations. Imagine you're a CMO and you have 6,000 marketers underneath you. How are you supposed to get alignment to your vision, to your strategies that you're setting if you don't have a way of connecting strategy to execution. And so the Scaled Agile Framework is a way of taking those Agile practices across multiple teams and up into the highest levels of the organization so that we're all moving in a similar direction.
Sean Blake:
Okay. Okay, I think that makes sense. And from a software team's point of view, one of the benefits of Agile is that it helps teams become more customer focused. And many would argue, well, marketing has always been customer focused. But have you found in your experience that maybe that's not so true? And when marketing teams start to adopt Agile, they realize what it really means to become customer focused.
Melissa Reeve:
Yeah. I mean, you raised another great point because I think most marketers think that they're customer focused. Like many things in the world, the world is a relative place. So you can, in your mind, in theory, be thinking about the customer or you can be actually talking to the customer. So I just finished what I call the listening session. And it was during our hackathon, which is our version of an innovation, couple of days worth of innovation. So it was eight hours on a Zoom call with somebody South Africa. Just listening to her experience and listening to her go through one of our courses, slide by slide, by slide, explaining what her experience was at each step of the way.
Melissa Reeve:
So if you think about somebody who is sitting in a large enterprise, maybe has never met the customer, only knows the customer in theory, on one end of the spectrum. And you think about this listening session on the other end of the spectrum, you start to get an understanding of what we're talking about. Now, your question really pointed to the fact that in Agile practices, you're thinking about the customer every time. In theory, every time you write a story. So when you write a story, you write the story from the perspective of the customer. And I would just encourage all the marketers out there to know the customer personally. And I know that's not easy in these large organizations. It's sometimes hard to get face time with the customer, but if you aren't speaking directly to a customer, chances are you don't actually know the customer.
Melissa Reeve:
So find a way, talk to the sales folks, get on the phone with some of your customer service representatives. Go to a trade show, find a way to talk directly to the customer because you're going to uncover some nuances that'll pay dividends in your ability to satisfy the customer. And when you go to write that story again, it will be even more rich.
Sean Blake:
Oh, that's really good advice, Melissa. I remember from personal experience, some of these large companies that I've worked in, we would say, "Oh, this is what the customer wants." But we actually didn't know any customers by name. Some of us personally were customers, but it's not really the same thing as going out and listening to people and what did they find challenging about using that app or what do they actually want out of this product? So there's a huge difference, isn't there, between guessing what a customer might want or should want? And then what their day to day actually looks like, and what are the things that they struggle with? That's hugely important.
Sean Blake:
For someone who's in one of these big companies, they're in a marketing team, perhaps they don't have the power or the influence to say, "Okay, now we're going to do Agile marketing." What would your advice be for someone like that, who can see the upside of moving their teams in that direction, but they don't necessarily know where to start?
Melissa Reeve:
Well, there's a philosophy out there that says take what you can get. So if you are just one person who is advocating for Agile marketing, maybe that's what you can do is you can advocate. Maybe you can start building alliances within the organization, chatting casually to your coworkers, finding out if you have allies in other parts of the organization and start to build a groundswell type movement.
Melissa Reeve:
Maybe you can build your own personal Kanban board and start tracking your work through your own Kanban board. And through visualizing your work in that way, it's a little bit harder now that we're all remote, but should we get back into offices somebody could in theory, walk by your cubicle, see your Kanban board and ask about it. And now you might have two people using a Kanban board, three people. And really start to set the example through your mindset, through your behaviors, through your conversations in order to start getting some support.
Sean Blake:
Oh, that's really good. So be the change that you want to see in the organization.
Melissa Reeve:
Exactly.
Sean Blake:
Okay. Okay, that's really good. And when these companies are moving towards this way of working, and then they're looking to take the next level, let's say it starts in the software development teams and then say marketing is the next team to come on board. How does it then spread throughout the whole organization? Because I know from personal experience, if there's still that part of the organization that's working anti-Agile it actually still makes it really difficult for the Agile teams to get anything done. Because there's still the blockers and the processes and the approvals that you need to go through with those other teams. And I guess SAFe is the answer, right? But how do you start to scale up Agile throughout the whole organization?
Melissa Reeve:
Sure. And what you're talking about is really business agility, is taking the whole business and making the business Agile. And you pointed out something that's key to that, which is once you solve the bottleneck and the impediments in one area of the business, then it'll shift to another area of the business. So the advantage of business agility is that you're trying to keep those bottlenecks from forming or shifting. But what a bottleneck essentially does is it creates what we call a burning platform. So it creates a need for change. And that's actually what we're seeing in the marketing side is we've got these IT organizations, they're operating much more efficiently with the use of Agile and with the use of SAFe. And what's happening is the software teams are able to release things more quickly than the teams that are surrounding them, one of which could be marketing.
Melissa Reeve:
And so now marketing is incentivized to look at ways of changing. They're incentivized to take a look and say, "Well, maybe Agile is the answer for us." So let's just say that marketing jumps on board and all of a sudden they're cranking along, and except for that everything's getting stuck in legal. And so now legal has a case for change and the pressures on legal to adopt it. So there is a way to let it spread organically. Most transformation coaches will understand this phenomenon and probably encourage the organization to just go Agile all in, obviously not in a big bang kind of way, but gradually move in that direction so that we're not just constantly shifting bottlenecks.
Sean Blake:
Okay. Okay, that makes sense. And when these companies are trying to build business agility across the different functions, are there some mistakes that you see say pop up over and over again? And how can we avoid those when we are on this journey of business agility?
Melissa Reeve:
Yeah. So I feel like the most common mistake, at least the one that I see the most often in marketing, although I've seen it in software as well, is people thinking that the transformation is about processes or tools. So for example, in marketing, they might adopt a tool to "become more Agile." Maybe it's a Kanban visualization tool, or maybe they're being suggested to adopt another common ALM type tool. And so they adopt this tool and they learn how to use it, and they wonder why they're not seeing big improvements.
Melissa Reeve:
And it's because Agile at its heart is a human transformation. So we're really taking a look at in trying to change the way people think. One of the topics I speak on is the history of management theory. And while it sounds pretty dry, in reality, it's eye opening. Because you realize that a lot of the habits that we have today are rooted back in the 20th and 19th centuries. So they're rooted in assembly lines. They're rooted in French management theory, which advocated command and control.
Melissa Reeve:
They're rooted in classism. There was a management class and a laboring, and the management class knew the one best way of doing things. So more than a process, more than a tool, we're talking about transforming this legacy of management thinking into a way that's appropriate for today's workers. And I feel like that's the number one mistake that I see organizations making as they're moving into transforming to Agile, an Agile way of working.
Sean Blake:
Mm-hmm (affirmative). Okay. Yeah, that's really interesting. And it really is eye opening, is it? When you look at how the nine to five workday came about, because that's the time when the factories were open and all the history around how organizations are structured. And it's really important, I think, to challenge some of those things that we've done in the past that worked back in the industrial age. But now we're moving into the information age and into these times of digital transformation. It probably doesn't work for us anymore, does it, some of those things? Or do you think some of those things are still valuable now that we have distributed teams, a lot of people are working remotely? Are there any things that come to mind that you think actually we shouldn't get rid of that just yet?
Melissa Reeve:
Oh, I'm sure there are. John Kotter has presented in his book, Accelerate, this notion of a dual operating system. So that you have the network part of the organization, which moves fast and nimble like a startup and then you have the hierarchical part of the organization. And the hierarchy is very, very good at scaling things. It's a well oiled machine. You do need somebody to approve your expense report. You do need some policies and some guidelines, some guard rails. And so we're not actually saying abolish the hierarchy. And I do feel like that's part of this legacy system. But what we are saying is abolish some of the command and control, this notion that the management knows the one best way, because the knowledge worker oftentimes knows more than his or her manager.
Melissa Reeve:
It's just too hard for a manager to keep up with everything that is in the heads of the people who report to him or her. So that's a really big change and it was a change for me. And I think why I got so fascinated in this history of management theory is because I came across some notes from my college days. And I realized that I had been taught these historic management theories. I'd been taught Taylorism, which stems from 1911. And I realized, wow, there's a lot of undoing that I've had to do in order to adopt this Agile way of working.
Sean Blake:
Well, that's great. Yeah, that's really important, isn't it? I've heard you speak before about this concept of walk-up work, especially in the realm of marketing. But I suppose, well, firstly, I'd like to know what is walk-up work. Why is it so dangerous, not just for marketers, but for all teams? And how do we start to fight back against walk-up work?
Melissa Reeve:
Yeah. So, marketers in particular get bombarded with what I like to call walk-up work. And that's when an executive or even a peer literally walks up, so think again about the cubicle farm, and makes a request. So how that looks in the virtual world is the slack or the instant message, "Hey, would you mind?" One is that it results in a lot of context switching and there's time lost in that context switching. And then the other part is rarely do these requests come in well-defined or even with any sort of deadline detach. In marketing, it might look like, "Hey, can you create this graphic for this email I'm sending out?" So now you've left your poor graphic designer with this knowledge that here she has to make a graphic, but they don't really have any of the specs.
Melissa Reeve:
So it's very, very helpful to put these things into stories, to follow the Agile process, where you're taking that walk-up work to the product owner, where the product owner can work with you to define that story, keep the person who's doing the work on task, not making them context switch or do that. Get that story in that acceptance criteria very well defined and prioritized before that work then comes into the queue for the graphic designer. And this is an anti-pattern, whether you're talking about an organization of 50 or 5,000.
Melissa Reeve:
And what I've found is the hardest behavior to change is that of the executives. Because not only do they have walk-up work, but they have positional authority too. And it's implied that, that person will stop working on whatever they're working on and immediately jump to the walk-up work being defined by the executive. So I feel like it's really dangerous to the whole Agile ecosystem because it's context switching, it interrupts flow and introduces waste into the system. And your highest priority items might not being worked on.
Sean Blake:
Okay. So how many people do you have on your marketing team at Scaled Agile?
Melissa Reeve:
We're pretty small, still. We've got about somewhere in the 20s, 23, 25, give or take or few.
Sean Blake:
So how do you-
Melissa Reeve:
I think right now we're three Agile teams.
Sean Blake:
Three. Okay. So those 20 something is split into three Agile teams. And do they each have a product owner or how does the prioritization of marketing work in your teams?
Melissa Reeve:
Yeah, it's a good question. So we do have individual product owners for those three product teams. And what's fascinating is the product owners then also have to meet very regularly to make sure that the priorities stay aligned. Because like many marketing teams, we don't have specialized skill sets on each of those teams. So for the group of 23, we only have one copywriter. For the group of 23, we have two graphic designers. So it's not like each team has its own graphic designer or its own copywriter.
Sean Blake:
Yes.
Melissa Reeve:
So that means the three POs have to get together and decide the priorities, the joint priorities for the copywriter, the joint priorities for those graphic designers. And I think it's working. I mean, it's not without its hiccups, but I think it's the role of the PO and it's an important role.
Sean Blake:
So how do you avoid the temptation to come to these teams and say, "Drop what you're doing, there's something new that we all need to work on?" Do you find that challenging as an executive yourself to really let the teams be autonomous and self-organizing?
Melissa Reeve:
Yeah, I think the biggest favor we've done to the teams is really, I don't want to say banned walk-up work, but the first thing we did is we defined it. And we said, "Walk-up work is anything that's going to take you more than two hours and that was not part of iteration planning." And iteration is only two weeks. And so, in theory, you've done it within the past 10 days. So if it wasn't part of that and you can't push it off to the next iteration planning, and there's a sense of urgency, then it's walk-up work.
Melissa Reeve:
And we've got the teams to a point where they are in the habit of then calling in the PO and saying, "Hey, would you mind going talking to so and so, and getting this defined and helping me understand where this fits in the priority order." And really that was the biggest hurdle because as marketers, I think a lot of us want to say yes if somebody approaches us with work. But what's happened is people have, myself included, stopped approaching the copywriters, stopped approaching the graphic designer with work. I just know, go to the PO.
Sean Blake:
That's good. So it's an extra line of defense for the team so they can continue to focus on their priorities and what they were already working on without being distracted by these new ideas and new priorities.
Melissa Reeve:
Yes. And in fact, I think we, in this last PI reduced walk-up work from 23% down to 11%. So we're not a 100%. And I don't know if we'll ever get to be a 100%, but we're certainly seeing progress in that direction.
Sean Blake:
Oh, that's really good. Really good. And so your marketing teams are working in an Agile way. Do you feel that across the board, not only within your organization, but also just more generally, are you seeing that Agile is being adopted by non-technical teams, so marketing, legal, finance? Are these sort of non-technical teams adopting Agile at a faster rate, or do you feel like it's still going to take some years to get the message out there?
Melissa Reeve:
Yeah. And I guess my question to you would be, a faster rate than what?
Sean Blake:
Good question. I suppose what I'm asking is, do you feel like this is a trend that non-technical teams are adopting Agile or is it something that really is in its infancy and hasn't really caught on yet, especially amongst Scaled Agile customers or people that you're connected to in the Agile industry?
Melissa Reeve:
I would say yes. Yes, it's a trend. And yes, people are doing it. And yes, it's in its infancy.
Sean Blake:
So, yes?
Melissa Reeve:
Yeah. So all of those combined, and I'm not going to kid you, I mean, this is new stuff. In fact, as part of that listening session I mentioned and we were talking about all these different parts of the business. And there was mentioned that the Scaled Agile Framework is the guidance to these teams, to HR, to legal, to marketing could be more robust. And the answer is absolutely. And the reason is because we're still learning ourselves. This is brand new territory that we're cutting our teeth on. My guess is that it'll take us several years, I don't know how many several is, to start learning, figuring out how this looks and really implementing it.
Melissa Reeve:
Now, my hope is that we'll get to a point where Agile is across the organization, that it's been adapted to the different environments. When I've seen it and when I've thought through things like Agile HR, Agile Legal, Agile procurement, the underpinnings seem to be solid. We can even things like the continuous delivery pipeline of DevOps. When I think about marketing and I think about automation. And I think about artificial intelligence, yeah, I can see that in marketing and I can see the need for this to unfold, but will it take us a while to figure out that nuance? Absolutely.
Sean Blake:
Okay. And can you see any other trends more broadly happening in the Agile space? You know, if we're to look forward, say 10 years, a decade into the future, what does the way of working look like? Are we all still remote or how are team's going to approach digital transformations in 10 years time? What's your perspective on the future?
Melissa Reeve:
Yeah, I mean, sometimes to look to the future I like to look to the past. And in this case I might look 10 or 12 years to the past. And 12 years ago, I was getting my very first iPhone. I remember that it was 2007, 2008. And you think about what a seismic shift that was in terms of our behavior and social media and connecting and having this computer in our hand. So I ask myself, what seismic shift lies ahead? And certainly COVID has been an accelerant to some of these shifts. I ask myself, will I be on airplanes as frequently as I was in the past? Or have we all become so accustomed to Zoom meetings that we realized there's power there. And we don't necessarily need to get on an airplane to get the value.
Melissa Reeve:
Now, as it pertains to Agile, I feel like in 10 years we won't be calling it Agile. I feel like it will look something more like a continuous learning organization or responsive organization. Agile refers to a very specific set of practices. And as that new mindset, well, the practices and the principles and the mindset, and as that new mindset takes hold and becomes the norm, then will we be calling it Agile? Or will it just be the way that people are working? My guess is it'll start to be moving toward the latter.
Sean Blake:
Well, let's hope that it becomes the normal, right? I mean that it would be great to have more transparency, more cross functional work, less walk-up work and more business agility across the board, wouldn't it? I think it would be great if that becomes the new normal.
Melissa Reeve:
Yeah, me too. Yeah. And I think, we don't call the way we manage people. We don't say, "Oh, that's Taylorism. Are you going to be practicing Taylorism? It's just the way we've either learned through school or learned from our bosses how to manage people. And that's my hope for Agile, is that we won't be calling it this thing. It's just the way we do things around here.
Sean Blake:
Great. Well, Melissa, I think we'll leave it there. I really enjoyed our conversation, especially as a marketer myself. It's great to hear your insight into the industry. And everything we've discussed today has been really, really eyeopening for me. So thank you so much for sharing that with me and with our audience. And we hope to have you on the podcast again, in the future.
Melissa Reeve:
Sean, it's been such a pleasure and I'd be happy to come back anytime.
Sean Blake:
Great. Thanks so much.
Melissa Reeve:
Thank you.
- Podcast
Easy Agile Podcast Ep.19 Combining Ikigai and OKRs to help agile teams achieve great results
In this episode, I was joined by Leandro Barreto - Lead Software Engineer at Miro.
Leandro is responsible for helping engineering and product teams to be more productive through metrics and KPIs with a focus on increasing their operational efficiency. Before moving to Europe, Leandro worked for an Atlassian partner company in Brazil as Head of Technical Sales.
In this episode, we spoke about;
- Ikigai - what is it and how do you achieve it?
- The benefits of OKRs
- How can we combine agile, Ikigai and OKRs?
- How Ikigai can help agile teams achieve great results and stay motivated
I hope you enjoy today's episode as much as I did recording it.
Transcript
Robert O’Farrell:
Welcome, everyone, to the Easy Agile Podcast. We have an episode today with Leandro Barreto who is a lead software engineer at Miro. I'm your host for today, Robert O'Farrel. I'm the Growth tech lead at Easy Agile. Before we kick off this podcast, I'd like to acknowledge the traditional custodians of the land from which we broadcast today, the people of the Duruwa-speaking country. We pay our respects to Elders past, present, and emerging and extend the same respect to all Aboriginal and Torres Islander, and First Nations people joining us today on the podcast.
Robert O’Farrell:
Leandro currently works as a lead software engineer at Miro where his responsibility is to help engineering and product teams to be more productive through metrics and KPIs with a focus on increasing their operational efficiency. Before moving to Europe, he worked for an Atlassian partner company in Brazil and acted as a head of technical sales with the mission to increase the service offers in Latin America. Welcome, Leandro. It's great to have you here today.
Leandro Barreto:
Yeah. Thanks, Rob. Thanks also for the Easy Agile for the invite. It's a pleasure to be here today.
Robert O’Farrell:
Fantastic. You're here to talk about Ikigai, objectives and key results or OKRs in Agile, so let's kick it off. Ikigai, what is it? Can you give us a brief or a long explanation of what it is?
Leandro Barreto:
Yeah, of course, of course. So, Ikigai I use it to say is a philosophy of life that means like a reason for being or the meaning of life. So, the world Ikigai originates from a village in Southern Japan, where the average life expectancy of people is over 100 years old. So, Ikigai is basically divided in four components. The first, things you love. Second, something that you are good at, then something that pays you well. And finally, something that the worlds need. So, when you put it all together, then you have the Ikigai, but this is not easy. So, let me explain a little bit of each of these companies.
Leandro Barreto:
So, the first thing is something that you love, something that makes you be present, something that you must ask yourself what do you really enjoy in doing? What makes you happy? What holds your intention that makes you lose time and forget about time? So, for example, reading, dancing, singing, painting, learning, teaching, et cetera. So, maybe it's a little bit difficult to answer right now, but understanding and seeking what you love must is fundamental so that you can have a healthy balance between learning, putting it in practice, testing, failing, trying again, and keep the circle repeating itself.
Leandro Barreto:
So, an example that I can give you is, for example, I had a jujitsu teacher that no matter the day, he was always training. And one day, I remember I got my arm hurt. And in the next day, I had a message from him like 6:00 in the morning, he was asking if I was okay. And I was waking up and he was texting me like, "Hey, are you okay? Are you going to be able to train today?" And I was like, "Whoa, take it easy, man." This is very funny because our class is 6:00 p.m. And he was punctually at the tatami or dojo. I don't know the English word for that.
Robert O’Farrell:
Yeah, dojo. We have dojo. Yeah.
Leandro Barreto:
Dojo. Awesome. Yeah. And he was always punctual. And after the classes, he always said that he wants to get home earlier after the classes because he has private classes. So, from morning to night, he always keeps training and you can see the passion in his eyes when he talks about jujitsu. "It's a passion for me". A little bit exaggerated.
Robert O’Farrell:
Something that definitely got him up in the morning and kept him going throughout the day to the late evening, by the sounds of it.
Leandro Barreto:
Exactly. Yes. And then, you have the second component, which is something that you are good at. Something that you can always improve with yourself. So, for example, what you are really good at. It's quite hard to answer, but what the people say is that I'm do... something correct or what they say something positive that what I do. So, for example, I remember the book Outliers by Malcolm Gladwell that says that usually, you have to spend 10,000 hours in something practicing to be good at.
Leandro Barreto:
So, don't take it as an obstacle but as a motivation to keep going, and understand this part of what you are good at. It's a good way to improve. And the third part is what pays you well? So, money is what... Some people say that "Hey, money don't bring... It's not... how can I say that?
Robert O’Farrell:
Money doesn't bring happiness?
Leandro Barreto:
Yeah, exactly. But it puts a roof in your head. It makes you provide a good life for your family. It makes you travel. It makes you have a hobby. So, according to Maslow, for example, one of the bases of human beings is to start thinking about security. So, we have to have this security in order we can improve as a person. So, money helps you to achieve it. Yeah. So, find something that makes your life as comfortable as you desire to, as you wish to. So, otherwise, you'll always be looking for something that you never had. So, for example, time.
Leandro Barreto:
So, you will spend so much time thinking how can you have more money? And here's the glitch, you will never be paid because you will be stuck on your daily basis thinking on how to get money instead of how to improve your skills to get money. Right? And then, you have the what the world needs. So, here, the idea is to find a proposal for what do you do and what is value to the society, your proposal. And sometimes it's quite difficult to find precisely because of the plurality of positions and responsibilities that we have nowadays. And even more today with the full expansion of technology that every month we have new positions to be filled by companies that needs different type of skills, soft skills and hard skills.
Leandro Barreto:
And here, the keyword is to serve. So, I will give a personal example. For example, one of the things that I missed most when I was a young teenager was having someone who could help me to explore the technology so I can get a job. So, it was in the early 2000 and it was quite hard.
Robert O’Farrell:
Yes, very much so.
Leandro Barreto:
The internet is starting, everything is new.
Robert O’Farrell:
People on dial-up, internet was slow.
Leandro Barreto:
Do you remember that sound like prshh?
Robert O’Farrell:
Oh, yeah. It comes to me in my dreams I think. I heard it so many times in that era.
Leandro Barreto:
My family and my friends, they wasn't in the IT field. So, there is no one to help me that. So, I had to learn it by myself. Seems impossible. But it took me time to learn it and enter in a company with a good position let's say that gives me money and the possibility to learn much more faster. So, since 2013, I dedicate part of my time to teach young people, acting as a mentor to help them enter in this market so they can learn new skills. I can open paths for them, put in contact with the right people, people which is going to be important for them, and all aiming to accelerate their dev development and giving them the opportunity.
Leandro Barreto:
And this for me is very meaningful because I'm helping those who don't have any references also, and sometimes don't have a chance. And the more I serve them, the more I earn and I grow with them. So, I came across like when I was introduced to Ikigai for example, another personal example.
Robert O’Farrell:
Sorry. Before we get to that, just reiterating. So, the four components, so there's something that you really lose time in doing, something that you get into the flow of doing very easily. And then, the second component is the thing that you are very confident in doing, something that you do quite well. The third one, being something that pays you well, and the fourth one, being something where there's a need for it. So, just reiterating that. That's correct?
Leandro Barreto:
Correct. Correct.
Robert O’Farrell:
So, I guess getting to that, our second question that like for yourself, you can apply obviously in a business sense, but in a personal sense, what's been your journey there, and do you believe you've achieved Ikigai, I guess, would be my next question?
Leandro Barreto:
Yeah. Well, actually personally, I have some things that's very clear in my life. I'm still not there, but let's say that I'm in the process.
Robert O’Farrell:
Work in progress
Leandro Barreto:
Exactly. Work in progress. So, I have clear goals and I have clear in my mind where I want to go in a few years, so I don't get disencouraged if the weather is cold or warm, if the stock market goes up or down. And the only thing that I focus is to be 1% better than I was yesterday. And this provides me a security that prevents me to wasting time and things that doesn't make any sense or simply doesn't matter for me in the future. So, I take my career very, and also my personal life very serious on that point. So, yeah, let's say that work in progress.
Robert O’Farrell:
I love that word security that you use there. It draws a parallel, I think, to a word that we also use when it comes to that plan that we have, which is that focus element, making sure that we do the things that matter. Do you think that it's also given you a sense of focus too on what you take on and what you say yes to and what you say no to with regards to your personal and professional development?
Leandro Barreto:
Yeah, absolutely. Absolutely. When you know where you want to go, it's more easy to say yes or no to something that came up to you. Another personal example that I remember was something like 12 years ago, 12 to 13 years ago, my focus was to learn Java, for example, Java programming. Because I know in the midterm, I would like to be a Java architect. So, I have to improve my skills on that programming language.
Leandro Barreto:
So, during that time, the company that I was working was making some changes and then they asked me, "Hey, I know you are good at Java. You are learning, but we need you to start learning this another language, Ruby on Rails during that time. But you have to at least for the moment, forget Java." And then, I was like, "Mm-mm. No, no."
Robert O’Farrell:
It's not what I want to do.
Leandro Barreto:
Exactly. I totally understand that was a company's decision. But during that point, it begins to separate my focus on what I want to achieve from the company's purpose. So, it doesn't make any sense to continue on that company. I asked to leave. And again, best decision ever, because then I entered in another company that I learned so much. And then, in three years I became a Java architect.
Robert O’Farrell:
Yeah. That's a fantastic example of that focus. I'm quite curious out of those four components that you mentioned before, what have you found quite easy, I guess, to achieve or to at least get clarity around personally? And what have you found more challenging?
Leandro Barreto:
Good question. Good question. Yeah. So, learning something that you don't know, it's always a challenge but when you have a desire or a clear focus where you want to go in a few years, things start to be clarified for you. For example, in 2014, I did extension of my MBA in United States to learn about entrepreneurship and things that for me was really, really important. But totally new field, I have no idea what to expect but it provides me the vision to... I always had the idea to have my own company in other words. So, I know that in short term, not in short term, but in midterm at least five years to four years, during that period of time, I would like to have my company.
Leandro Barreto:
So, after I did this MBA, I came back to Brazil, and then I started to put myself in situations that makes me learn these new things. And in 2016, I open up our restaurant in Brazil. So, when you have an objective, things, and it's quite funny because the universe starts to help you.
Robert O’Farrell:
You make your own luck in a lot of regards too, I think.
Leandro Barreto:
Yeah.
Robert O’Farrell:
So, if you had somebody who was looking to learn about Ikigai and came to you for some, for your experience and your advice in how to apply it to their lives, what do you think your advice to someone would be who doesn't know much about it?
Leandro Barreto:
Good question. Great question. So, one tip that I, or advice that I can give is, and I think that this is fantastic and I apply it in my daily basis. Don't waste time in small decisions on a daily basis because every day we have thousands of decisions to make and our brain capacity is limited daily, at least daily. So, there are some times that we feel like mentally exhausted after, for example, you have six meetings in a row in a day. In the end of the day, you were totally tired. Right? And I once read that the greatest minds don't waste time thinking on small things, for example, Steve Jobs always wore the same jeans and t-shirt every day. And he didn't need to think to use it. He just took it and reuse it.
Leandro Barreto:
So, during that time, what I did in 2018, more or less when I was presented to Ikigai. So, what I did, I lived alone in an apartment in Brazil. So, I decided to change it, my life. What I did, I donated my entire wardrobe of clothes with things that I almost never used. And I was only wear eight t-shirts and two jeans.
Robert O’Farrell:
Quite a collection.
Leandro Barreto:
So, I avoid making those small decisions, especially in the morning, because in the morning, you have a clear mind and you don't have to spend those in small things, because if you think on small things, probably it'll grow during the day. So, for example, another thing that helped me a lot is plan the week. So, Google Calendar exists to be used, right?
Robert O’Farrell:
Yeah. Yes.
Leandro Barreto:
So, everything that is very important for you, events or plans that need to be done, put on the calendar. And also, talking about the clothes, separate your clothes a day earlier before you go into bed. So, you wake up more calmly, you drink your coffee calmly, and you focus your efforts on what really matters. And once you have freed your mind from thinking about these small things, you can focus your time and energy on learning new things or getting things done the way it should be. And whether it's learning a new language or a new skill, or you can also read a book in the morning because you have free time, let's say. You can focus on what matters to you exactly.
Robert O’Farrell:
Yeah. I'm quite curious about this aspect of finding something that you really get consumed by. And I think in this digital age, we have so many things that distract us. Our phone has a lot of notifications where we have a lot of information at our beck and call and sometimes it can be overwhelming to know what we should focus on, and I guess what we can really get passionate about. I'm curious, do you have any insight into that as to how people can find that thing that they just lose themselves in and that they're super passionate about?
Leandro Barreto:
Yeah, absolutely. Absolutely. Another thing that worked very well for me is to turn off all the notifications.
Robert O’Farrell:
Get a dumb phone just so you don't have that level of notifications coming through. Yeah.
Leandro Barreto:
Yeah. Because I read... I don't remember where exactly, but your brain took something like 15 minutes to focus on something. So, if you don't spend 15 minutes of your time, focus on what needs to be done. You cannot focus at all. So, what I usually do, I turn off all of the notifications from my phone. So, the principal one, I just took it off and I don't care about notifications. Also, one thing that I noticed is that when I, for example, when I had Apple Watch. In the Apple Watch, even if you turn the notifications on or off, the iPhone, it keeps doing on the phone. Oh, my God. So, this is one simple device that I can say, because otherwise, you will enter in a black hole in a community and social media and news, and then you'll lose yourself.
Robert O’Farrell:
Yeah. I found that personally with the Apple Watch, having something on your wrist that vibrates is incredibly distracting. And I was always very big champion of technology, but that was one area where I just moved away from it, went back to a mechanical watch, just didn't want that level of interruption when I was trying to focus on things. So, I think it's a really key insight to focus.
Leandro Barreto:
Yeah. In addition to that, when you, for example, when you are in a meeting with someone and you are actually expecting a message for, I don't know, maybe your family, and then it pops up on your phone and you are in a meeting, and then you take a look into the watch and the people notice that you are not paying attention because you are looking into watch. No matter why you are looking, if it's a message or et cetera, you do provide a psychology... How can I say that in English? Oh, my God. Psychology interference. Let's say it.
Robert O’Farrell:
Yep. Psychological interference.
Leandro Barreto:
Interference. Yeah. Thank you. That will provide a negative influence to other people. So, yeah, that's why you made the right choice to move into the-
Robert O’Farrell:
Yeah. I've heard some people that will actually ask people to leave their phones outside when they go into meetings or leave their laptop outside so that you're present and that you are engaged in the conversation. Because I think even the mere fact that you have your phone near you is a distraction. Even if there's no notifications, its presence is enough to ensure that you're not 100% present in the conversation, which I think is quite interesting from how we focus and our dependency on that rush that we get or that endorphin rush of getting that ping on the phone or that notification.
Leandro Barreto:
Exactly.
Robert O’Farrell:
I thought we could move on to talk about objective and key results. Or for those people that may not have come across this term before, OKRs are collaborative goal-setting methodology and used by teams and individuals to set challenging and ambitious goals with measurable results. So, to break that down further, the objective part of the OKR is simply what is to be achieved and the KR part of it, which is key results, benchmark and monitor how we get to the objective. So, getting to the heart of setting successful OKR is establishing it clear and compelling why. Is there a secret formula to creating a powerful why to get everyone on board?
Leandro Barreto:
Yeah. Great question. So, OKRs, it's all about action and execution. And I think the secret formula, let's say it's having a well-defined proposal and also everyone engaged in seeking the result as the main objective. So, companies in my opinion are made of living ecosystem called human beings. And every human being has its own desires, proposals, goals. And en suite, unite all of the objectives of both the companies and all the people together. That's when we can achieve best results. And that's why some companies are focused on the cultural fit.
Leandro Barreto:
And this is one thing that I see growing a lot in the HR area, companies and persons that must, which the cultural fit must match. It basically means that the person has the same values and desires to achieve results as most of the people in the company or what the company understand as their force that they need to keep growing as a company. And I have seen many technically good people failing in selection, in process selection, simply because they don't adhere to cultural fit. And this is much more than a psychological issue because you don't know how to say like people that cannot work as a group.
Leandro Barreto:
So, it's better for the company to hire someone who can play as a team instead of someone who is like the lonely wolf that keeps working alone. And the results is for only him and not for the entire company. So, yeah, this is the classic example that I can see. And also, one thing that is good for that is nowadays, our fault tolerance is quite good because today at least serious companies don't punish failures. So, they even encourage you to learn.
Leandro Barreto:
And the Spotify models, I remember they say like, "Fail fast and learn fast." So, that was the fail wall was born. So, where everyone shared their failures and they can learn as a team, as a clan, guild. And this is quite beautiful because you can create such an environment where everyone can learn and grow together because humans can fail. And this is normal.
Robert O’Farrell:
Do you think that-
Leandro Barreto:
And-
Robert O’Farrell:
Sorry, I'm just curious. Do you think that companies are more focused around the why these days, or that why has become more important in their measure of success? And you mentioned cultural fit and I love this idea that more companies are much more sensitive to what is their company culture and how does this person work within, or are they going to fit into this company culture? Because the existing people in that company are aligned around their why. And if someone is coming in and doesn't align with that, they understand the impact on their success. So, do you think that company's becoming more and more aware of this and more sensitive to this?
Leandro Barreto:
Yes. I think they are. So, as far as they have the right people in the right environment with the right proposal, no matter the why they will find it blindly, let's say. I think it's like a sense of behavior for the people. Because if you see someone from, as your peer, let's say, that's running to an objective that was defined by the company. And you are aligned with your values and goals. You will follow it.
Leandro Barreto:
So, this is good for both persons as human beings and also for the company because they show the proposal, they show what is the why we must be, for example, the first selling company for our product in the market, why, and then people who is working on it, they will take it as a personal objective. And this is when you make the connection between the company's objective and the people's objective because when the company grows with this why, with this north star, the people will grow together with you.
Robert O’Farrell:
I completely agree. I'm quite curious too from the opposite point of view. Do you think that employees are becoming more aware of understanding the company's why before they join the company? Because we've seen with the pandemic that a lot of companies are now moving to this remote recruitment. And so, the possibilities for employees to work for a much broader range of companies now have increased. And do you think that employees are now finding better wire alignment when they're looking for new jobs because they do have a broader pool to play in per se?
Leandro Barreto:
Absolutely. Absolutely. I think that's why Glassdoor is so popular. So, when you are invited for a meeting or for an interview, you can see everything from the company. Like from salary to feedbacks from the people who works there or is not working anymore. And then, you can see if there's a match. And this is quite funny because like 10 years ago, which is not so popular, we are blindly thinking to work, let's say, in a position like software development. So, I have to be a software developer. I have to be a...
Leandro Barreto:
So, it was more focused on the position instead of the purpose. And now we are seeing the opposite. Now, the people are looking for the purpose, what the company can help me achieve. And it's more like a win-win-
Robert O’Farrell:
Situation.
Leandro Barreto:
... situation let's say, situation. Exactly.
Robert O’Farrell:
Yeah, I couldn't agree more. And I think also a lot of people are really focused on how the company takes care of them as a person. They're very sensitive to the fact that they are committing their time to that company. So, there has to be that alignment around professional goals and personal goals. And I think that it's a great shift to see, to come back to the OKR side of things. I'm curious about what benefits do setting OKRs within an organization give or provide?
Leandro Barreto:
Yeah. I think OKRs, they are very, very simple. They do not require a specific knowledge to implement it. So, when you have the people committed and engaged to the goal and the why they want to achieve, then the implementation and using of OKRs became naturally. So, company can benefit because he's straight to the point. He's like, "Objective, it's the direction. And the key results are yes or no." So, keep it simple. That's the main benefit of the companies.
Robert O’Farrell:
Yeah. I love that. The fact that there's no gray area. You either succeed or you don't, and there's a lot of clarity around that as well.
Leandro Barreto:
Exactly.
Robert O’Farrell:
I think that with that aspect of OKRs, in your experience, have you seen OKRs set that tend to stretch the team further than they normally would be stretched in terms of what they attempt to achieve than companies that don't set OKRs from your experience?
Leandro Barreto:
Yes, but I think it matters on what the company, what's the culture of the company, because I have seen companies that is setting OKRS in the good way, but I have seen companies that is setting OKRS because it's fancy. When it's fancy, you don't have a clear objective. You don't have a clear vision. You don't have the right people. And then, it's very tricky and you will never achieve what you are proposing.
Robert O’Farrell:
I'm curious to dig into that a bit more to get your insight on that. Because as somebody who would come into a company that might be setting OKRs, how would you determine that the OKRs are probably not as clearly defined or that they're implementing a process that don't necessarily have the depth or the belief in doing? So, how would somebody come in and determine that?
Leandro Barreto:
Good question. Good question. So, the idea to have a objective is like to have something that can be... How can I say that, can provide you like a, not a fear, but it's going to be like, provides you a direction for, but the people who sees it, they think like, "Hey, this is quite hard to achieve I think." So, one example for Google, for example. So, Google in 2008, they tend to launch the Google Chrome. And as I remember, the first year was like, "Hey, this is the objective." Like, "Hey, we want to launch the best browser in the world." And the key result is the number of users because the users will tell you if the browser is good or not.
Leandro Barreto:
In the first year, they didn't achieve the key result. But the second year, they rise at the bar again, like, "Hey, now we are much than double the objective." And the second year, they still didn't achieve it. But it was very, very close to it. And the third year, they pass it. So, keep in mind that the objectives must be something that seems like a challenge, a huge challenge, but at the same time, it's very inspirational.
Robert O’Farrell:
Inspirational.
Leandro Barreto:
Inspirational. Thank you so much. For those who are working on it. So, I think this is most of the point.
Robert O’Farrell:
Yes. And what do you see as some of the pitfalls when setting OKRs for an organization?
Leandro Barreto:
Awesome. Awesome. So, the pitfalls from my perspective, there are some common mistakes when implementing OKR. So, for example, as I said, not having a clear vision of the goal, so people cannot engage. And especially when you have senior engineers because they don't want to work in something that don't bring purpose for them. Right? So, this is the first one, for example. The second one could be like a system that supports the monitoring of the results. So, you cannot follow up, which is quite important to keep following it if you are, we are close to achieve it. Yes or no? So, a good point.
Leandro Barreto:
And one thing that seems quite strange, but it's very, very common in the market is that your product is not finished yet. One personal example that I faced not quite recently, but do you play video games?
Robert O’Farrell:
When I get the time. I have two young boys, so I get very little time to do that these days. But yeah, I do.
Leandro Barreto:
Yeah. I love doing, I don't have also time, but when I have a litle bit of time, I can spend. So, this little time I try to spend in the best game that I found in the market. And here is the point because some years ago, there was a game that was released and before released, there was several gaming platforms, new sites, and et cetera, that was telling us that, "Here is the game challen... no, the game changing for the gaming market, because it's going to be very good. The marketing for this game was really, really good. And the game was like highest expectations for that. It was always in the top. "Hey, you have to play this because it's going to be very great. You are going to be having a great experience on that."
Leandro Barreto:
And the funny thing is that after they launch it, a few hours later, I notice some YouTubers who start testing the game. They began to post videos about so much bugs that they are facing. And within a week, the game had to stop selling because that was a disaster.
Robert O’Farrell:
Yeah.
Leandro Barreto:
And... Yeah.
Robert O’Farrell:
I was just going to say, I can think of a few games that come to mind that fit that criteria.
Leandro Barreto:
Yeah. Probably we are thinking the same, but I can say it, so.
Robert O’Farrell:
Yeah. Yeah. Do you find that people get OKRs and KPIs confused within an organization? Or have you ever come across any examples of that, where people misunderstand the purpose of between the two of them?
Leandro Barreto:
Yes. One thing that came up to my mind is the key result is a simple measure to understand if you are going in the right direction to your objective or not, but KPIs is it's more a performance index for performing for your team. For example, if they are performing in a good way, if we have the right resources for delivering something. And so, I think this is mainly the difference is the KPI, it's a measure for you to, maybe to bonus, to create a bonus for your team or et cetera. And the KR must be not linked to bonus or salary, et cetera. Must be like a direction. Something that, yes, we are achieving it or not. Or if not, what we have to do to correct the direction.
Robert O’Farrell:
Yeah. Fantastic. So, coming around to Agile, I'm curious about this marrying of the two, of OKRs and Agile together. How can we combine Agile and OKRs in your experience and your understanding to achieve results that drive high performance?
Leandro Barreto:
Awesome. So, as the Agile manifesto says, "People over process," so I believe whenever you maintain a fail-safe environment along with a good leadership, you can get the most of your team. So, connecting what I said earlier regarding the Ikigai and when you have a good leader, for example, in a safe environment and colleagues or peers who shares the same values and goals as you, then you can extract maximum efficiency because high-efficiency teams are teams that are focused and committed with the company results, and that will achieve great business results. Sorry.
Robert O’Farrell:
I also love that aspect with the OKRs, with that clear definition, too, that Agile, that processes is that sprint by sprint activity where you're going back and you're looping around and looking at the results of that sprint and going back to the customer and getting customer feedback and that real alignment around what you're trying to achieve as well, to give you that clarity of focus that when you are going through that sprint process, you're coming back and saying, "Okay, are we acting on the initiatives that have come out of these key results that contribute to that OKR?"
Leandro Barreto:
Exactly. And also, adding to that, that's why we have the goal for the sprint, right? So, we have the direction for the sprint. So, every sprint you can measure if you are achieving this goal or not.
Robert O’Farrell:
And I love it as a mechanism, too, to link back to that, that why piece to really give a clarity around why, which I think a lot of software development sometimes doesn't focus as much as they can on. So, I'm curious, so how can Ikigai mix into this? So, we've talked about that at the start and we talked about the components of it and it was a great framework about understanding a purpose, but how can we use that to achieve better results and stay motivated as a team?
Leandro Barreto:
Great question and also quite difficult. But yeah, I believe there are two thin lines that eventually met in the future. For example, the first one is like the individual as a person. So, how he seems himself in, within the organization and how can benefit, how this relationship can benefit from this win-win relationship. And also, the second one is like the individual as a professional. So, based on the skills that he already has. How can he help the company achieve the results more efficiently?
Leandro Barreto:
So, in a given timeline, these two lines will cross and then you will be able to extract excellent results because you will have a person with excellent internal knowledge, internal as a person, and also engaged with the companies is seeking as a greater objective, as a north star, and also helping your peers to grow all together.
Leandro Barreto:
And I think this is quite like a smile. When you smile at someone unconsciously, you make the other people smile too. So, when you have someone who is genuinely working with a proposal, that person will contaminate other in a good way. And then, you have a continuous string of people delivering consistent results. And I think this is the most important.
Robert O’Farrell:
Have you experienced that yourself where you see someone working with purpose and contaminate or infect how you... infect is again, not a great word, but inspired is probably the best word there, inspired the people around them to work in a similar fashion. Has that something that you've witnessed yourself?
Leandro Barreto:
Yes, yes. I remember back in the company that I was working in Brazil, that was my first day. I was like, "Hmm, there's something strange here," because everyone is so passionate on delivering their best results for their customer, that this thought influenced me in a positive way to start being like hungry for good results, not only for the company but for me as an individual, as someone who have to learn and teach others. And nowadays, I see these companies, it's achieving a great results with a great leader because even if we have a good team, we have to get someone who is a servant leader, who you can follow and maybe follow blindly in a good way. But yeah, I experience it.
Robert O’Farrell:
That's fantastic. But I'm interested, is there anything that you wanted to talk about personally with regards to either of those three topics or even outside of that, that has been inspirational, I think, in your professional development, in your personal life?
Leandro Barreto:
Yeah, absolutely. Absolutely. I think Leandro five years ago was totally different person. And when I started looking, not only by myself inside me, but also outside and the opportunities that the world can give me and how can I serve back this, or how can I provide this back to the world? This is very funny because good things start to happen. For example, I never imagined to be working here in Amsterdam. And now, I'm here in Amsterdam, working in a great company with great people, delivering such great results, which is giving me a lot of knowledge to keep learning and keep the wheel turning on, keep the cycle.
Leandro Barreto:
And I think today, like performing the best Leandro's version ever, maybe tomorrow, a little bit more, and I can provide this knowledge to other person and I can also learn from other persons, from other people. And that's very exciting. I think that's what motivates me to wake up in the morning, do my sport things like running and jujitsu, and then let's do the work.
Robert O’Farrell:
That's fantastic. I love that, that reflection on the past five years, how far you've come. It sounds like you've had a lot of inspiration from a number of different sources, but is there something in there that you think was key to that? Or was it just a general progression over that time?
Leandro Barreto:
Yeah. Yeah. Actually, I tried to focus on people who have positive influence on others. So, I try to be more not equal because if you are equal, so you are the same person, so it doesn't provide value to the others, but try to be quite different in your own way. So, yeah, basically, that's what motivates me to get different sources of references and trying to be the best version of myself.
Robert O’Farrell:
That's fantastic. I love this mix of the philosophical, which is for me, the Ikigai, and the concrete, well, not concrete, but the workflow aspect of the Agile side of things coming together. Have you traditionally worked in Agile methodologies or did you transition between that may be starting, because if you're from the 2000s, so you probably touched on Waterfall at some point in the past and then came into Agile. Was that your professional progression over that time?
Leandro Barreto:
Yeah. Yeah. Actually, I worked a lot with the Waterfall methodology in 2008, when I was introduced to the Agile methodology with Scrum... no, actually 2009, then I saw. "Hey, this is very, very interesting." Let's learn more about it. And then, during this time, I keep working both with the Waterfall methodology and the Agile methodology. And the more I work it with the Waterfall, the more value I saw in the [inaudible 00:54:24]-
Robert O’Farrell:
In Agile. Yeah.
Leandro Barreto:
Yeah. And that was quite fantastic because then I also learn about SAFe and how to scale it, and yeah.
Robert O’Farrell:
I'm quite curious, like because we had a similar path in that regard and I reflect on where we are with OKRs and Agile, and it's interesting that Agile brought us closer to our customer and we speak to our customer on a more regular basis, which I thought was a massive win over Waterfall where you might have months and months of development, and you've got a requirement that you're trying to put into code, and then suddenly, you have this big delivery and that's when you talk to the customer. And usually, the customer comes back and says, "We want all these things changed." And it's a real pain.
Robert O’Farrell:
Agile was instrumental in that, but then going up from there and putting that layer of why on top of that, which I think is, again, one of those big fundamental shifts on how we focus on what we are doing. Do you see anything emerging from your experience, your professional experience that is tackling another key challenge with regards to, I guess, how we work and how we deliver value?
Leandro Barreto:
Yes. And for example, the customer, they want to see value on what is going to be delivered. They don't want to spend six months to wait something to be delivered. So, I think that's why cloud start being so popular, like SaaS companies, because when you are working on something that is on cloud, for example, you always have the last version. And no matter the day or the hour of the day, there will come new features. And usually, it's transparent for you. And internally from the engineering perspective, the more you deliver, the more quickly you can correct and the more you can understand the market.
Leandro Barreto:
And also, that's why some strategies, some release strategies came up so popular like Canary release. So, you deliver a few things to a particular person, and then you can test it. And if they provides you good or bad feedback, you have time to correct it. So, that's why it became so popular. So, I think during this time from now on, we must see a lot of SaaS companies starting to growing because things are in real life now, real time now, so I think it's natural.
Leandro Barreto:
By the way, there's a good strategy that was implemented by Spot 5 if I'm not mistaken that was like, but this is more for engineering perspective. They have some robots that keeps doing bad things to the servers.
Robert O’Farrell:
Oh, that's the Chaos Monkey.
Leandro Barreto:
The Chaos Monkey.
Robert O’Farrell:
That was Netflix. Yeah. Yeah.
Leandro Barreto:
Netflix, yeah.
Robert O’Farrell:
Netflix. And it would take down bits of their infrastructure and break things. Yeah, yeah.
Leandro Barreto:
Exactly. It's quite hard to see in some companies, but I think this has become to be more popular during the next couple of months or years, because it will teach the engineers how to deal with that because no one wants to stay working in the weekend. You stay with your family.
Robert O’Farrell:
Yeah. I completely agree. I remember when I first heard about the idea of the Chaos Monkey, that it shocked me that someone would inflict that upon their business and upon, I guess, their systems, but then it only takes a production incident to realize that if you had something like that, that you would've built in some provision should that eventuate. And I think that there's a lot of wisdom to it. And so, I absolutely love the idea. I love this, what you were saying about real-time delivery of value to customers.
Robert O’Farrell:
And I think back to how Agile has really been fundamental in pioneering that, well, not pioneering it per se, but with the release cadence that you get from one to two-week sprints, you're putting yourself in a position where you are delivering more often. And you mentioned Canary deploys, I think within that. Is there any other deployment strategies that you've come across that also support, I guess, that immediate delivery of value to customers?
Leandro Barreto:
Yes. There is another strategy which is called the Blue-Green release, but the difference between it is like the Canary release, you deliver something in the small portions, but the Blue-Green, you, like a switch that you turn on and off.
Robert O’Farrell:
Yes. Yes. Right.
Leandro Barreto:
Yeah, you can test it. You can deliver new version of your environment or your tool, and then everyone can use it. And if something goes failed, then you have the plan B, where you can just turn on and off, and then you can rearrange the traffic to your tool. But this is very technical.
Robert O’Farrell:
Yeah. Very interesting to me, but we might lose a few of our podcast listeners. One last question from me, just within your current professional engagement, were they implementing OKRs before you joined the company? Or was that something that you've seen introduced over that period of time?
Leandro Barreto:
From my current company, they are currently working with OKRs, so I didn't participate and implemented it. So, I'm just more focused on helping the teams in implementing the KRs. There were some companies that I worked in the PEs that I helped to build it, and also to build not only the objective but also the KRs. And the objective, it's you spend so much time because you have to understand where the company wants to be in the future.
Leandro Barreto:
So, you have to know inside what we have, what we can improve, where we can improve, and then we can base it on that, base it on the objective. We can build up to four key results to be more precise in achieving this. Yeah. But it's quite challenging, but at the same time, very exciting.
Robert O’Farrell:
I think that was going to be my question in your experience in seeing a company go from not doing that to then implementing it, what were the real challenges in doing that? And how long did you see that process take before they really got good at doing that? Because it is not only setting the meaningful objectives and obviously measurable key results but also then getting the alignment from the teams around that. What were the big challenges there and how long did you see that process take?
Leandro Barreto:
Yeah. I think it depends from company to company. I remember back in Brazil, I had to work with companies that spent months on deciding, but at the same time, I remember my own company took three months to start implementing it. So, I think it depends on the commitment of the people who is responsible for this objective. So, yeah, depends on the maturity also of the company, the people who is working, and yeah. Because the OKRs are quite old, but at the same time are quite new for people, for the companies. Right? So, this is like very challenging. And how do you balance it?
Leandro Barreto:
There are some people who doesn't know how to set the correct objective. And then, we came up with the same thing that we are discussing earlier. Like if you don't know where you're going to go, if the objective is not clear enough, no matter if you have good people or bad people, the people will not see value on that.
Robert O’Farrell:
Yeah. And you won't get your alignment because people don't either understand or don't believe in the objective.
Leandro Barreto:
Exactly.
Robert O’Farrell:
That's fantastic insight, Leandro. And I really appreciate your time today. Again, is there anything that you'd like to chat about before we wrap it up? I'm just conscious that we have been chatting for about an hour now and gone off script a little bit too.
Leandro Barreto:
Yeah, absolutely. Absolutely. No, actually I'd like to thank you, Rob. Thank you, Agile team, everyone. I don't want to spend much time talking also. It was a pleasure and thanks for invite again. And I hope we can think good things in the future. Like, "Hey, I hope I can provide good insights on this."
Robert O’Farrell:
That's fantastic. You certainly have. I've learned a fair bit today as well. So, I'll be going back to revisit some of the talking points from this chat. So, thank you very much again for your time, Leandro. I really appreciate it. And, yes, have a great day. It's kicking off for you and it's ending for us. So, yeah, really appreciate it, mate.
Leandro Barreto:
Thank you. Thank you. I really appreciate it too. Thanks again. See you. Have a great day.
Robert O’Farrell:
You too. Cheers.
Leandro Barreto:
Cheers.
- Podcast
Easy Agile Podcast Ep.25 The Agile Manifesto with Jon Kern
"Thoroughly enjoyed my conversation with Jon, he shared some great perspectives on the impact of the Agile manifesto" - Amaar Iftikhar
Amaar Iftikhar, Product Manager at Easy Agile is joined by Jon Kern, Co-author of the Agile Manifesto for Software Development and a senior transformation consultant at Adaptavist.
Amaar and Jon took some time to speak about the Agile Manifesto. Covering everything from the early days, ideation, process, and first reactions, right through to what it means for the world of agile working today.
They touch on the ideal state of an agile team, and what the manifesto means for distributed, hybrid and co-located teams.
We hope you enjoy the episode!
Transcript
Amaar Iftikhar:
Hi everyone. Welcome to the Easy Agile Podcast. My name is Amaar Iftikhar. I'm a product manager here at Easy Agile. And before we begin, Easy Agile would like to acknowledge the traditional custodians of the land from which we broadcast today, the people of the Dharawal speaking country. We pay our respects to elders past, present, and emerging. And extend that same respect to all Aboriginal, Torres Strait Islander, and First Nations peoples joining us today.
Today, we have on the podcast Jon Kern, who is the co-author of the Agile Manifesto for Software Development and an Agile consultant. If you're wondering, you're correct. I did mention the Agile Manifesto for Software Development. The Agile Manifesto. So Jon, welcome for being here and thank you for joining us.
Jon Kern:
Oh, my pleasure, Amaar. Thank you.
Amaar Iftikhar:
Yeah, very excited to have you on. Let's just get started with the absolute basic. Tell the audience about, what is the Agile manifesto?
Jon Kern:
Well, it's something that if you weren't around, and I know you're young, so you weren't around 21 years ago, I guess now, to maybe understand the landscape of what software development process and tooling and what most of us were facing back then, it might seem like a really obvious set of really simple values. Who could think that there's anything wrong with what we put into the manifesto? But back in the day, there were, what I practiced under as a... I'm an aerospace engineer, so I was in defense department work doing things like fighter simulation, F-14 flat spins and working with a centrifuge and cool stuff like that. And subject to a mill standard specification, which makes sense for probably weapons systems, and aircraft manufacturing, and all sorts of other things. But they had one, lo and behold, for software development. And so there was a very large, what I would call heavy handedness around software development process. We call it heavyweight process. Waterfall was the common term back then, and probably still used today.
And there were plenty of, I would say the marketing juggernaut of the day, IBM and Rational unified process, these large, very much like Safe. Where it's a really large body of work, awesome amount of information in it, but very heavy process even though everything would, say you tailor it, it could be whatever you wanted. I mapped my own lightweight process into REP for example. Sure. But the reality was we were facing kind of the marketplace leader being heavyweight process that was just soul crushing, and from my perspective, wasting taxpayers' money. That was kind of my angle was, well, I'm a taxpayer, I'm not going to just do this stupid process for process sake. That has to have some value, has to be pragmatic. So lo and behold, there were a handful of us, 17 that ended up there, but there are a handful of us that practiced more lightweight methods. So the manifesto was really an opportunity for coming together and discovering some of the, what you might think of as the commonality between many different lightweight practices. There was the XP contingent. I first learned about Scrum there, for example. Arie van Bennekum, a good friend, he taught us about DSDM. I don't even remember what it stands for anymore. It was a European thing.
Alistair and Jim Highsmith, they had, I forget, like crystal methodologies. So there was a fair amount of other processes that did not have the marketing arm that erupted, or didn't have the mill standard. So it was really all about what could we find amongst ourselves that was some sort of common theme about all these lightweight processes. So it was all about discovering that, really.
Amaar Iftikhar:
You all get together, the principles kind of come to fruition, and let's fast forward a little bit. What was the initial reaction to the original manifesto?
Jon Kern:
Yeah, it was even kind of funny that the four values, the four bullets is as simple as it was. The principles came a bit later. I want to say we collaborated over awards wiki, but the original... If you go to Agile uprising, you can see I uploaded some artifacts, because apparently I'm a pack rat. And I had the original documents that Alistair probably printed out, because he was the one... He and Jim lived there near Salt Lake City. So it was like, "Hey, let's come here." And we like to go skiing, so let's do it here. So he arranged the room and everything. And so there's some funny artifacts that you can find. And the way that it actually came about was an initial introduction of each of us about our methods. And really I think a key, we left our egos at the door. I mean I was a younger one. Uncle Bob, some of these, he was at Luminar, I know I have magazines still in the barn that he was either the editor of, or authors of for people who don't remember what magazines are. Small little booklets that came out. So Uncle Bob was like, Ooh, wow, this is pretty cool.
And I wasn't shy because I had a lot of experience with heavyweight methods. So I really wanted to weigh in on... Because I had published my own lightweight method a few years earlier. So I had a lot of opinions on how to avoid the challenges of big heavyweight process. So the culmination as we were going out the door and after we had come up with the four values was I think Ward said, "Sir, want me to put this on the web?" And again, this is 2001 so dot com and the web's still kind of new so to speak. And we're all like, yeah, sure, why not? What the hell, can't hurt. We got something, might as well publish it. I don't think to a person, anybody said, "Oh yeah, this is going to set the world on fire because we're so awesome." And we were going to anoint the world with all of this wonderful wisdom. So I don't think anybody was thinking that that much would happen.
Amaar Iftikhar:
Yeah. So what were you thinking at that time? So how would the principles that you had come up with together, was that maybe just for the team to take away? Everyone who was there? What was the plan at that time?
Jon Kern:
I think it was a common practice. Like I said, there were other groups that would often meet and have little consortiums or little gatherings and then publish something. So I think it was just, oh yeah, that's a normal thing to do is you spent some time together and you wrote things down, you might as well publish it. So I think it wasn't any deeper than that other than Bob, I think Bob might say that he wanted to come up with some kind of a manifesto of sorts or some kind of a document because that's I think what those sort of... I was never at one of those gatherings, but you know, you could see that they did publish things. I have a feeling it was just something as innocent as, well we talked, wrote some things down, might as well share it.
And then the principles, there were a lot of different practices in the room. So some of what I would say the beauty of even the values page is the humility at the top is it's still active voice. We are uncovering not, hey all peasants, we figured it all out. No, we're still uncovering it. And the other thing is by doing it, because I'm still an active coder. And plus we value this more on the left, more than on the right. Some people might say it's a little ambiguous or a little fuzzy, but that's also a sign of humility and that it's not A or B. And it really is fuzzy, and you need to understand your context enough to apply these things. So from a defense department contracting point of view, certainly three of the four bullets were really important to me because I learned... Sure, we did defense department contracting. But it's way more important to develop a rapport with the customer than it is... Because by the time you get to the contract you've already lost, which goes along with developing a rapport with the customer, the individual.
And one of Peter Codes, when we worked with customers and whatnot, one of our mantras was frequent tangible working results, AKA working software. You can draw a lot and you can do use cases for nine months, but if you don't have anything running, it's pretty, I would guess risky that you don't have anything, no working software yet. So it really was I think an opportunity to share the fact that some people thought two weeks and other people thought a month. Even some of the print principles had a pretty good wide ranging flexibility so to speak. That I think is really important to note.
Amaar Iftikhar:
Yeah, no, absolutely. And it makes sense. Did you or anyone else in the room at that time ever imagine what the impact downstream would be of the work that was being done there?
Jon Kern:
Not that I'm aware of. I certainly did not. I remember a couple times in my career walking in and seeing some diagrams when I worked with the company Together Soft, and we'd build some cool stuff and I'd see people having some of the... Oh yeah, there's a diagram I remember making on their wall. That's kind of cool. But nothing near how humbling and sort of satisfying it is. Especially I would say when I'm in India or Columbia or Greece, it almost seems maybe they're more willing to be emotional about it. But people are, it's almost like they were freed by this document. And in some sense this is a really, really tiny saying it with the most humility possible. A little bit like the Declaration of Independence, and the fact that a handful of people... And the constitution of the United States. A handful of people met in a moment of time, never to be repeated again and created something that was dropped on the world so to speak, that unleashed, unleashed a tremendous amount of individual freedom and confidence to do things. And I think in a very small, similar fashion, that's what the manifesto did.
Amaar Iftikhar:
As you mentioned, there was a point in time when the manifesto was developed and that was almost over 20 years ago. So now the way of working, and the world of working has drastically changed. So what are your thoughts on that? Do you see another version coming? Do you think there are certain updates that need to be made? Do you think it's kind of a timeless document? I'd love to hear your thoughts on that.
Jon Kern:
Yeah, that's a good question. I personally think it's timeless and I welcome other people to create different documents. And they have. Alistair has The Heart of Agile, Josh Kerievsky's got Modern Agile.
There's a few variations of a theme and different things to reflect upon, which I think is great. Because I do believe, unlike the US Constitution, which built in a mechanism to amend itself, we didn't need that. And I believe it captured the essence of how humans work together to produce something of value. Mostly software, because that's what we came to practice from, is the software experience. But it doesn't take a lot of imagination to replace the word software with product or something like that and still apply much of the values that are there with very, very minor maybe adjustments because frequent tangible working results.
There might have to be models, because you're not going to build a skyscraper and tear it down and say, "Oh, that wasn't quite right," and build it again. But nonetheless, there are variations of how you can show some frequent results. So I think by and large it's timeless. And I would challenge anybody. What's wrong with it? Point out something that's somehow not true 20 years later. And I think that's the genius behind it was we stumbled on... And probably because most of us were object modelers, that's one of the things we're really good at, is distilling the essence of a system into the most critical pieces. That's kind of what modeling is all about. And so I think somehow innately, we got down to the core bits that make up what it is to produce software with people, process and tools. And we wrote it down. That's why I think it's timeless.
Amaar Iftikhar:
Yeah, no absolutely. I think that was a really good explanation about why it's timeless. I think one of the principles that comes to mind in a kind of modern hybrid or flexible working arrangement is one of the principles talks about the importance of face to face conversations. And in a world now where a lot of conversations aren't happening physically face to face, they might be happening on Zoom. Do you think that still applies?
Jon Kern:
Yeah, I think what we're finding out with... Remote was literally remote, so to speak, back 20 years ago. I was working with a team of developers in Russia and we had established enough trust and physical... I would travel there every month. So kind of established enough of a team, and enough trust in the communication that we could do ultimately some asynchronous work because different time zones. And me being in the east coast. 7:00 AM in the US was maybe 3:00 PM in Russia if I recall. St. Petersburg. So we were able to overcome the distance, but it's hard to beat real life. And I would often sometimes even spar a little bit with Ron Jeffries that on the one hand you could say the best that you can do is in person. But on the other hand, I could argue a little bit of some of the remoteness makes things... You have to be a little more verbose, possibly a little more precise, but also a little more verbose. A little more relaxed with... You might take a couple of passes to get something just because, I mean there are two time zones passing in the night. But that was based off of some often initial face to face meetings, and then you could go remote and still be successful and highly effective.
So I think it's important that teams don't just say that they can still do everything. And zoom is way better than 20 years ago, admittedly. Zoom gets, at least you can see a face. But nothing replaces the human contact. And I think also for wellbeing, I think human contact is important. So I would still say that the interaction aspect in the manifesto is still best served with a healthy dose of in-person. And that's kind of the key about most things in Agile. It's to me it's about pragmatism, and not just being dogmatic but rather, what might work better for us? And even experimenting with try something a little bit and see how that works. So even how you treat the manifesto, you should treat it in an Agile manner so to speak.
Amaar Iftikhar:
Yeah, no absolutely. That's a great point. On that note, as an Agile consultant or the Agile guy, what have you seen are the best practices or what works, what doesn't work for distributed teams?
Jon Kern:
Well I think the things that are most challenging that I've run across big companies and even smaller ones is that... I don't know if it's natural, God forbid if it's natural, but tendencies that I've seen in some companies to set up silos where you're the quality control, you're the UX, you're the front end, you're the back end, makes my headwater explode. Because that's building in a lag and building in communication roadblocks and building in cooperation which is handed offs from silo to silo, versus collaboration. So I've seen more of that. And I get it, you might want to have a specialty, but customer doesn't care. Customer wants something out the door. If I showed up and I'm going to pull a feature off the stack, what do you mean I can only do part of it? I don't get that. And yeah, I know I'm not an expert in everything but we probably have an expert that we can figure out what the pattern is. So I find that sort of trend, I don't know if it's a trend, but I find that's a step backwards in my opinion. And it's better to try to be more cross-functional, collaborative, everybody trying to work to get the feature out the door, not just trying to do your little part.
Amaar Iftikhar:
Yeah, a hundred percent. I think knocking on silos is a big part of being agile, or even being digital for that matter. And often the remedies for it too are there at hand, but it's a lot harder to actually be practical with it, to actually implement it in an organization, a living, breathing business where there's real people and there's dynamics to deal with, and there's policies and processes to follow. So I guess as generic as you can be, what is your thought as an Agile consultant to a business that's kind of facing that issue?
Jon Kern:
One of the things that... Adaptive is what my colleague John Turley has really opened my eyes to. I tend to call it the secret sauce, or the missing piece to my practice. And it has to do with individual's mindset and what we call vertical development. So it might sound like weird wishy-washy fluffy stuff, but it's actually super critical. And I've always said people, process, and tools for, I want to say since late nineties probably, I mean a long time. And the first I've been able to realize why sometimes I would have just spectacular super high performing teams and other times it'd be just really, really well performing but not always that spark and sometimes kind of like, eh, that was a little meh. And a lot of it comes down to where people lie on in terms of how they make their meaning and what their motivational orientation is, command and control versus autonomy.
So what we do is we've learned that we can help people first off recognize this exists, and help people with what we call developmental practices. Something that, even the phrase, you probably heard it, like safe experiments. Failure, or trying something and failing. Well if you chop someone's head off for it, guess what? They're just going to probably stay pretty still and only do what they're told, not try to... I have a super high dose of autonomy in me, so I've long lived by the, better to beg forgiveness than ask permission, and always felt as long as I'm trying to do the right thing to succeed and do the best for the company, they probably won't fire me if I make a mistake. But not everybody has that amount of freedom in the way they work. So you have to help establish that as management, and that's a big thing that we work with, with teams.
And then we also start with the class. If you've ever watched office space, and if you haven't you should, but the, what is it that you do here? So there's a great, the consultants Bob and Bob coming in, the efficiency consultants, "So Amaar, what is it that you do here?" But literally that's something, whether we're helping teams build a new product, is okay, what's the purpose? What's the business purpose of this product? What is it that you do here? What do you want to do with this product? What value does it provide? Same thing with anything you're working with as a team. And that's why whether it's software, producing some feature that has an outcome that provides value to the customer, or some product. But the point is if you don't understand that, now it's making, the team is going to have a real hard time being able to make decisions which are helping us move forward.
So if you help everybody understand what it is we're here to do, and then try to get the folks that might reflect all the different silos if you're siloed, but all the different elements. How do we go from an idea to cash, so to speak, or idea to value in the customer's hand? And have a good look at that. Because there are so many things that just sort of... Technical data often creeps into software code bases. And the same thing, we sort of say the organizational debt, the same thing can happen. Your process debt. You can just end up with, all right, we want the development team to go faster, John and company, can you come in and help coach us? We want to go agile. Sure, okay yeah. All right. We roll up our sleeves, we look around and after an initial kind of value stream look, like, wait I'm sorry but there's a little tiny wedge, it's about 15%, that's the development. And then you spent the 85% thinking about it.
Let's pretend we could double the speed of development. Which was initially the... Yeah, we need the developers to code faster or something. That's a classic. And no you don't, you need to stop doing all this bullshit up front that's just crazy ass big waterfall project-y stuff with multiple sign-offs. And matter of fact, one of the sign-offs, oh my gosh it only meets once a week, and then if you have a typo in it, you get rejected. You don't come back for another... Are you insane? You spent eight months deciding to do eight weeks worth of work. Sorry, it's not the eight weeks. So things like that, what I recommend anybody self inspect is try to... If you're worried about your team, how you can do better is just start trying to write down what does your process step look like and what is a typical time frame?
How much time are you putting value into the... Because a lot of times people batch things up in sprints. That's a batch, why are you putting things in a batch? Or they have giant issues. Well that's the big batch. So there's lots of often low hanging fruit. But to your point, it's often encrusted in, this is the way we work and nobody feels the ability to change or even to stop and look to see how are we working. So I think that's where we usually start is let's see how you actually work today. And then while we're doing that you can spill your guts, you can tell us all the things that hurt and that are painful and then we'll try to design a better way that we can move towards, in terms of working more effectively. Because our goal is to help teams be able to develop ways to do more meaningful and joyous work, really. Because it's a lot of fun when it's clicking and when you're on a good team and you're putting smiles on the customers' faces, it's hard to almost stay away from work because it's so much fun. But if it's not that, if it's drudgery and you're just a cog in the machine and stuff takes months to get out the door, it's a job. It's not that much fun.
Amaar Iftikhar:
Yeah. A lot of the points that you mentioned there strongly resonated with me, and the common pain points. It sounds like you've kind of seen it all. And by the way if you haven't seen office space, definitely need to watch it. It's a really good one. You've mentioned now a lot about of the element of the challenges that a distributed team faces. Now I want to flip it over and ask you what does the perfect distributed team look like today that lives and breathes agile values?
Jon Kern:
Yeah. I don't know if you can ever have such a thing, a perfect of any kind of team. So I would say harking back to the types of distributed teams that I've worked with, and this goes back to the late nineties. So I've been doing this for a long, long time. Only really done remote, whether it was with developers in Russia or down in North Carolina, or places like that. And I think that the secret was having a combination of in-person... If you want to go somewhere as a group, there are things you can do to break the ice, to establish some, what you might call team building type activities.
And not just, hey let's go do a high ropes course and be scared out of our wits together. But rather also things that are regarding why are we here, what are we trying to achieve? And let's talk about whether it's the product we're trying to build, and take that as an opportunity to coalesce around something and get enough meat on the bone, enough skeletons of what it might look like. Because there's good ways to start up and have a good foundation. And that's part of what I've been practicing for decades. If you get things set up properly with understanding that just enough requirements, understanding... And I do a lot of domain modeling with UML and things like that, just understanding what the problem domain is that we're trying to solve to achieve the goals we're looking for, have a sense of the architecture that we want. So all those things are collaborative efforts.
And so if you have enough of a starting point where you've worked together, you come in and, let's say you even had to go rent someplace, because nobody lived near office, so you all flew somewhere. I mean that's money well spent in my opinion. Because that starts the foundation. If you've broken bread so to speak, or drank some beers, or coded together and did stuff, and then you go back to your remote offices to take the next steps and then realize when you might need to meet again. So that's really important to understand that the value of establishing those relationships early on so that you can talk bluntly. And I have some good folks that I run a production app for firefighters since like 2006.
Amaar Iftikhar:
Yeah, very cool.
Jon Kern:
And that friend that I've worked with, we are so tight that we can... It makes our conversations, we don't have to beat around the bush, we don't have to worry about offending any, we just, boom, cut to the chase. Because we know we're not calling each other's kids ugly. We're just trying to get something done fast.
And building that kind of rapport takes time and effort and working together. And that's what I think a good successful distributed team, you need to come together every so often and build those relationships and know when you might need to come together again if something is a problem. But that I think is a key to success is it shortens the time. Because you may have heard of things like the group forms, if this is performance on the Y axis they form and they're at some performance level, then they need to storm before they get back to normal, and before they start high performing. So it's this form, storm. You get worse when you're storming. And storming means really understanding where we're at. When we argue about, I don't think that should be inheritance, Amaar. And then you're like, "Oh bull crap, it really..."
And again, we're not personal, but we're learning each other's sort of perspectives and we're learning how to have respectful debates and have some arguments, so to speak, to get to the better place. And I've worked in some companies that are afraid to storm, and it feels like you're never high performing.
Everyone's too polite. It's like, come on. And I love when I worked with my Russian colleagues. They didn't give a crap if I was one of the founders. And I'm glad, because I don't want any privilege, I don't want anything like that. No let's duke it out. May the best ideas win. That's where you want to get to. And if you can't get there because you don't have enough of a relationship, and you tend not to say the things that needed to be said because you're being polite, well it's going to take you really long to succeed. And that's a lot of money, and that's a lot of success, and people might leave.
So I think the important thing is if you're remote, that's okay, but sheer remote is a real challenge. And you have to somehow figure out, if you can't get together to learn how to form and storm, and build those bonds face to face, then you need to figure out how to do it over Zoom. Because you need to do it, because if you don't, if you never have words, then trust me, you're still not high performing.
Amaar Iftikhar:
Yeah, I kind of feel like being fully remote now is being offered as almost a competitive advantage to candidates in the marketplace now, because it's a fight for talent. But if I'm understanding correctly, what you are saying is that in-person element is so important to truly be high performing and those ideas kind of contradict each other, I feel.
Jon Kern:
Yeah. And again, having been remote since the late nineties, I've been doing this a long time. And commuting to Russia is the longest commute I ever did, for three years. I mean that's a hell of a long flight to commute there over seven times, or whatever the hell it was. Anyway, I used to say that that being remote is not for everyone, because it really isn't. I mean you have to know how to work without anybody around, and work. I mean it has its own challenges. And yeah, it might be a perk, but I think what you need to do is look at potentially what the perks are and figure out too, can I fold them into... It doesn't have to be all or nothing. And I think that can be a easy mistake to make maybe is to, all right cool, we don't have to have office space. That's a lot of savings for the company. Yeah, but maybe that means you need to have some remote workspaces for occasional gatherings, or figure it out.
But yeah, I think even... And certain businesses might work differently. In the beginning of building a product, I want to have heavy collaboration and I want to get to a point where it's almost, I feel like the product goes like this where once you get things rolling and you kind of get up, get some momentum going, now the hardest thing to do is be in front of an agile team, whether they're in-person or remote. Once things are rolling and rocking and kicking and it's like everything's clicking, you can just bang out features left, like boom, boom, boom. Yeah, okay then we probably need to be...
Unless we've got ways that we're pairing or things like that. I will say when we're together, mobbing is easier. I'm sure there's ways to do it remote, but being in a room, I don't know, it's a lot easier than coordinating over Zoom. You just, hey there's this problem, let's all hang out here after standup because we're just going to mob on this. So it doesn't take a whole lot versus anything remote, there's a little extra, okay, we've got to coordinate, and even different times zones, gets even worse. So yeah, don't get carried away with remote being the end all be all. Because I have a feeling there's going to be a... I would wager there will be a backlash.
Amaar Iftikhar:
And I'll take that back coming from the Agile, the person who does this day to day who helps teams become agile, I'll definitely kind of take your word for it. Plus with my experience too, I've seen nothing really beats a good white-boarding session. That is really hard to replicate online. I mean we have these amazing tools, but nothing quite mimics the real life experience of just having a plain whiteboard and a marker in your hand. That communication is so powerful.
Jon Kern:
Great point. You're so, right, because I had just with the one company that I was with for five years, we were doing high level engineered to order pump manufacturing sales type tool for... So it was my favorite world because it blended my fluid dynamics as an aerospace engineer, plus my love for building SaaS products, and building new software and things like that. And even having a young, we would interview at Lehigh University and we'd have some young graduates that would be working with us, and being able to bring them into the fold, and there was a room behind where my treadmill was and we'd go in there, we'd have jam sessions on modeling and building out new features. And man, you're right. Just that visceral three dimensional experience. Yeah, Miro's great. Or any other kind of tool, but yeah, it's not the same. You're absolutely right. That's a great point. You're almost making me pine for the good old days. [inaudible 00:42:04]
Amaar Iftikhar:
I think the good old days very much still exist. I think even now, it's kind of been a refreshing time for me to be with Easy Agile. I've only been here for just under two months now. And there's a strong in-person dynamic. And again, it's optional, where if people are remote or they're hybrid or they need to commute once in a while, it's a very understanding environment. But once you're in the office or you're in person, you kind of feel the effect you were describing, you're motivated to deliver for the end customer. You just want to come back. It's an addictive feeling of, I want to be back in person and I want to collaborate in real time in person.
Jon Kern:
That's beautifully said, because that's... One of the companies that we're beginning to engage with in South Africa, they're at this very crossroad of struggling with, everybody's been remote, but boy, the couple times we were together, got so much done. And you're describing the flame of, the warmth of delivering and let the moths come to the flame. I mean nurture it and then fan the flames of the good and let people opt in and enjoy it. And still sometimes, yeah, I got to say home, I got the kids or the dog, that's okay too. But giving the option I think is where we're going to head. And I believe the companies that are able to build that hybrid culture of accepting both, and neither mandating one nor the other, but building such a high performing team that basically encourages people to opt into the things that make the most sense at that time. And I think that those companies will rule the day, so to speak.
Amaar Iftikhar:
Yeah, absolutely. It's been so nice to chat with you John, and I've really enjoyed this. I want to leave the audience off with one piece of advice for distributed agile teams from you. We've talked a lot about the importance of in-person collaboration. We've talked about the principles of the agile manifesto. Now, what would the one piece of advice be when you're thinking of both? When you want the agile manifestos to be something that's living and breathing in distributed agile teams, what one piece of advice can you give businesses today right now who are going through the common struggles? What can you tell them as that last piece of advice?
Jon Kern:
Well, I think kind of a one phrase that I like to use to capture the manifesto is, "Mind the gap." In my sort of play on words, what I mean is the gap in time between taking an action and getting a response. Whether it's what do we do about the office, what do we do about remote, what do we do about this feature, what do we do about this line of code? The gap in time is, it's sort of a metaphor about being humble enough to treat things as a hypothesis. So don't be so damn sure of yourself one way or the other about the office or remote or distributed. But instead, treat things as a hypothesis. Be curious and experiment safely with different ways and see what works. And don't be afraid of change. It's not a life sentence to, you got to run your business or your project or your team one way for the rest of your life. No. Don't tell the boss, but work is subsidized learning. I never understood people who just keep doing the same thing because they weren't given permission. Just try it. So that's what my departing phrase would be regarding making those decisions. Mind the gap and really be humble about making assumptions, and test your hypotheses, and shorten the gap in time between taking actions and seeing a reaction.
Amaar Iftikhar:
Oh, that's awesome. Thank you. I really wish we could let the tape roll and just keep talking about this for a couple more hours, but we'll end it right there on that really good piece of advice that you've left the audience off with. Jon, thank you again for being on the podcast. And we've really, really enjoyed hearing you and learning from your experiences.
Jon Kern:
Oh, my pleasure. Any time. Happy to talk another couple hours, but maybe after some beers.
Amaar Iftikhar:
Yeah.
Jon Kern:
Except it's your morning, my evening. I'm going to have to work on that.
Amaar Iftikhar:
Yeah.
Jon Kern:
My pleasure, Amaar.



