No items found.

Easy Agile Podcast Ep.14 Rocking the Docs

Listen on
Subscribe to our newsletter

"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.30 Aligned and thriving: The power of team alignment

    "Every time I meet with Tony, I'm always amazed by his energy and authenticity. In this conversation, that really shone through."

    In this episode Hayley Rodd - Head of Partnerships at Easy Agile, is joined by Tony Camacho - Technical Director Enterprise Agility at Adaptavist. They are delving into the highly discussed subject of team alignment, discussing what it means to have synchronized goals, cross-functional collaboration, and a shared agile mindset.

    They also cover the fundamental building blocks to get right on your journey to team alignment, like the power of listening and embracing mistakes as learning opportunities, stressing the importance of following through on retrospective action items + so much more.

    We hope you enjoy the episode!

    Share your thoughts and questions on Twitter using the #easyagilepodcast and make sure to tag @EasyAgile.

    Transcript:

    Hayley Rodd:

    Here at Easy Agile, we would like to say an acknowledgement of country. This is part of our ongoing commitment to reconciliation. Easy Agile would like to acknowledge the traditional custodians of the land from which we broadcast and meet you today. The people of the Darova-speaking country. We pay our respects to elders past, present, and emerging, and extend the same respect to all Aboriginal, Torres State Islander and First Nations people listening in today. Hi all and welcome to the Easy Agile Podcast. My name is Hayley. Here's a little about us here at Easy Agile. So we make apps for Atlassian's Jira. Our applications are available on Atlassian's marketplace and are trusted by more than 160,000 users from leading companies worldwide. Our products help turn teams flat Jira backlog into something more visually meaningful and easy to understand.

    From sprint planning, retrospectives and PI planning our ups are great for team alignment. Speaking of team alignment, this is what this episode is all about. Today I'm joined by Tony Camacho. Tony is the technical director of Enterprise Agility for Aligned Agility, which is part of the Adaptiveness group. I've met Tony a few times during my time here at Easy Agile and have learned that he's one of the most generous people along with being funny and a clever human being who is incredibly knowledgeable about Jira and a bunch of other agile related topics. It's really wonderful to have Tony on the podcast today.

    Hey, everyone, we've got the wonderful Tony Camacho on the podcast today. This is our first time recording from our Easy Agile Sydney office, which is super cool. Tony, I'm not sure if you know, but Easy Agile is based out of a place called Wollongong, which is just south of Sydney. But we've got a Sydney office because we've hired a bunch of Sydney team members recently who wanted a place to come and hang out with each other. So we created this space, but it's 7:00 AM in the morning, so I'm all alone right now. That's how much I love you. So Tony, let's get started on the questions. Team alignment. What does it mean for a team to actually be aligned?

    Tony Camacho:

    So for us in an agile space that we're having, it's a collective understanding, a synchronization of your team members towards goals, principles, your practices that you're going in. Even more so I would even go down to the point of cadence, you would have those synchronizes. So it's a matter to be consistent with your agile principles and values, your mindset, your shared goals and vision, your synchronized work practices, DevOps, [inaudible 00:02:44], how we're going to put this out. Cross-functional collaboration between the teams, getting your tea shaped partners/teammates shining at that moment, learning from each other, roles, responsibilities things of that type. That's what it means to me. It really means.

    It's all about human beings and at that point, having everybody aligning and working to our common goal, that objective that we want to do for the business partner. There's the gold that we're all after as a team. Does that make sense for you guys? We have the same objectives for this initiative and our practices. And finally for me, which I know this is not typically is we're coming to an agreement on the tools we're going to use and how we're going to use them and have a system source record where we know where we can get our troops, our dependencies, find out which teams do have capacity and move forward from there. That would be my overall definition of an agile team.

    Hayley Rodd:

    Wow.

    Tony Camacho:

    And teams.

    Hayley Rodd:

    You've had lots of experience over the years. I guess where my mind goes when you say all those really wonderful things about team alignment is that in my experience when team alignment is when people get it right, it's super great. When people get it wrong, it's really hard. And I actually think it's pretty hard to get team alignment right. You got to really work at it. What's your experience in that?

    Tony Camacho:

    To me it's like it can be a bad marriage or a great marriage, but it needs work. As we know, all relationships need work. We're human beings, we're not the same. Each one of us brings something to the table of value. So let me give you one example that I've lived with on a team. I'm an extrovert by nature, and I'm a developer, an engineer and typically that is not two skill sets that you hear together. So I've had to learn that when I'm working with my teammates that happen to be sometimes introverts slow down, listen, wait. They've also had to try to learn to respond faster because as an extrovert, if I ask you a question, all of a sudden I'm looking at you, I'm not getting a response, I'm thinking you're not understanding the question. I rephrase the question and now you're in a deficit to two questions.

    And now I'm even worse because now I'm like, "Hayley isn't understanding me. What's happening here? Let me rephrase it again." And it can easily fall apart. What I have seen when teams aren't in alignment is that the team isn't a team any longer. It's miserable to go to the team. It's miserable to come into work, when the team is truly aligned, you're rocking and rolling. It's a feeling like you've never had. It's hard to explain to people that when you see the team, because you know it when it's working and you obviously know when it's not working, you're starting to miss deadlines. Integrations aren't happening on time. You don't have a single source of truth. You start having people explaining the same thing in two, three different matters, different priorities. We're not working from the same hymnal. The thing that I took from my... I'm an SPC, so as an instructor, the one thing I always try to explain to everybody, you may have the best of everything out there, but that's not necessarily mean it's going to work together.

    So you have to have that type of understanding, how we're going to work together, what is our priorities, what's the tool sets we're going to have and what is our values as a human beings to this team if that... I'm hoping that helps describe some of the things that I've seen that have gone really bad. I have seen it at, I can share a customer that I have seen it gone, but we started off with good intentions. It's a financial institution in the United States and they were trying to make the jump to mobile applications. And at first we were on the same page as a team, but they decided that they didn't believe that cadence was required to be the same across the board. They didn't believe that we could use the same one tool set, we could use multiple different tool sets.

    They had spreadsheets flowing all over the place. And what was happening was we lost trust. We were redoing work, there was ambiguity everywhere. We were misaligned and we started paying for it because our customers started complaining. They could see it in the quality of the work. One team had one schema, one background, one type of... You could see the difference when they integrated, it seemed like it was two applications being put out there mashed together. And when you're misaligned, that comes through very, very quickly in your work. There's a saying that we have here. There's a scrum master, I know her name was Sophia Chaley, one of the best I ever met. And what she will always tell people is what a team delivers is what the team is doing is learning. It's building knowledge, it's expressed as code. When we're misaligned, we're learning different things and we're expressing it differently in the code, if that makes sense.

    Hayley Rodd:

    Like thinking about the fundamental building blocks of team alignment, is there something that a team really needs to get right to be successful at alignment? And what is that in your mind?

    Tony Camacho:

    Oh, that is for sure. They had to get that right. First of all, the size of the team.

    Hayley Rodd:

    Yeah, okay.

    Tony Camacho:

    Human beings, and I'm not referring back... Going back to say for our scrum practices, I am a CSM. I do know they recommend 8 to 13 people. My best teams have been typically a little bit larger than that. But we had to have the same agreed to the size of the team where it didn't became, didn't become too large where we were over running each other and we weren't listening to each other. We had to understand our goals. We all had the same goals. We used to practice this by, when I worked at Microsoft, we used to have what we used to call our elevator speech. And we would stop somebody and I would go, we're working on this. Watch your elevator speech for this. And if your elevator speech wasn't... It wasn't meant that it had to be in sync with mines, but if I didn't understand it, we had a problem.

    Or if it was a different goal where I'm looking at you going, but we're building a Volkswagen, but you're describing to me a Lamborghini, we have a problem. And those were the type of things that we also had to have to make sure that we had the right... Same practices and the tools. That's where I find Easy Agile exceeds. I mean it just exceeds, it meets above the market. It's transparent and it shows everything in front of you right there for me. So when we had the same tool and we were having the same cadence and we could see our dependencies and we could see what I had to deliver for somebody else or somebody had to deliver it for me, that was the types of things we had. We had to have respect. Somebody seems to always forget that we always had to have respect for each other.

    We had to embrace the same values of collaboration, adaptability, transparency. The practices that we all know, but somehow we seem to forget when we get into a place where we are not aligned and if you respect my ideas and I respect yours and we're working together, we do not have to agree. But that respect will drive us a long way towards getting to that project vision that we want. And we're trying to meet the customer's needs. And those are the type of things that we needed. We needed leadership. Leadership, I can't say, and if you notice I'm not using the word management, leadership is where you're putting yourself out there in a situation where it can go bad for you as a person, as that leader, trying to make sure that we're making the right choices empowering the people and making them very clear what they can make decisions on and they can't. And it sounds so simple when I talk to you like this, but every time I've had to do some type of transformation, the baggage that sometimes we bring as human beings, the fears, the lack of trust that we have, that's where the scrum masters of product owners come in. And then you need something to make sure that you're having that vision to communicate that vision across. As I mentioned before, some of the tool sets that we have out there. Is that making sense for you at all?

    Hayley Rodd:

    Yeah, it really does. It's really resonating with me. I think when you talk about coming together as a team and putting together a set of values and a vision, it seems so much like a a "duh" moment. It's like, of course you would do that as a team, but I think at the end of the day as teams, we get in the daily business as usual and we think, I don't have time to get together as a team and set that vision because I've got to do X, Y, and Z, that's due next week. But I think it's one of those fundamental building blocks that really sets you up for success to do X, Y, Z quicker down the track. So that's what I've taken away from that.

    Tony Camacho:

    And I would agree with you. And you came up with a perfect example because a lot of people do that. I have ABC to do for next week, daily. I don't have time. And the problem is that if they would suddenly realize, and it does become apparent to your practices. So once you agree on your practices, your daily standups, if you're doing that, your retros at the end of your sprints and moving forward, once the person feels that they have that respect for you and they're not fearful, they can share that with you, "Hayley, I'm having a problem. I'm having way too much work. I don't know if I am going to be of value here. Or Do you really need me?" "Yes Tony, I do need you, we're going to discuss this and let's discuss your A, B, C and see how I can help you." And they suddenly realized they're not on an island alone. Developers by nature being introverted, we have to break that habit. We have to be able to share. And it's funny, I'm not saying share my lunch, fine, sure, let's share our lunch, but share the workload.

    The one thing that I always try to mention to teams, and again that's... I'm sorry, but I do believe in Easy Agile, using this tool. That's where easy Agile also to me makes it apparent. A story belongs to a team, not to a person. And once you know that you suddenly realize, I'm not alone. I'm here working as part of a bigger thing. And most human beings want to be part of a bigger thing. You suddenly realize that it's almost like the baseball metaphor that I use for teams. And I know the market is not baseball, but I think it would apply for other sports, be cricket or sports like that. When I'm batting, it's me against everybody. When I'm on the field, it's us against... I prefer being with the us. And generally that's where things like that, let's do that.

    Also, when you're working with more people as a team, there's things that happened there. You minimize the project risk, which I hate using the word project. It should be initiative. It's long living. You're usually a much more adaptable. I don't know all the answers. So when I worked with you, Hayley, and you showed with me some things there, you're one of the most humble people I've met, and I loved it. But when you walked through, you walked me through the tool, it became very apparent, you know it, you feel it, you love it, it's part of you. And that to me is invigorating. It's energy. Who wouldn't want to work with somebody like you? Why not? Let's do this. Right?

    Hayley Rodd:

    Thank you Tony. I guess one of the things that I wanted to touch on is when you're in a team and you're coming together as a team, you're working on something, how does an individual who seeks recognition for what they're doing, how do they get that? Or how do you leave that? How do you put that ego aside and say, "I'm doing something as a team to the better of the team?" Have you ever come across that or considered that? I'm interested in your thoughts.

    Tony Camacho:

    So the people that I felt that needed to have that typically how I... Yes, that's a great question because I'm thinking specifically. There was one, a scrum master that I thought that did it the most amazing way ever. Basically she would call out the ideas even if it wasn't that person's, yeah. I feel that Hayley is... You're not having a good day, Hayley. You're not having a good day. And I know you are not getting used to doing, working in the scrum team. It's new to you and everything else. And what she did typically was in front of everybody would be, and it wasn't even your idea sometimes. And she would just say, and Hayley came up with this wonderful idea that's going to save us something, move us forward. Hayley said this to me, it made us think as a team. And we went around it, we talked and we did it.

    And that person always usually would be like, "Wow, I got credit for something. Good scrum-masters will see that. Or good product owners will point that out." The other way that I've done it was using something like Easy Agile. It's a great tool to use, believe it or not. I would back off, I'm a developer, but I also played the role of Scrum masters for years. I would step back and I would let one of my teammates run it, hear their voice, feel empowered. It's amazing when you can have people feel empowered because what you're all talking about, there really is about a lack of trust, a lack of psychological safety. And it's for us to be an aligned team, you have to have trust there and you have to break down the fear of judgment. So the other thing that one time happened with a scrum master that I thought was wonderful was is that again against Sophia Chaley, chief stood in front of her room when there was this a bad sprint.

    The sprint didn't end well. And she stood up in front of everybody and she basically went, "Sometimes you win, sometimes you learn. This was a learning sprint." She pulled up Easy Agile, she was using at a time, pulled it up, showed the things that didn't work out the way they thought they were going to work out. And she said, these are the actions we're going to take to improve this. And then when somebody who was in management, again not using the term leadership, now I'm using the term management on purpose, was looking to assign blame. Her response was, not screaming, not raising her voice. Her response was, if we need to get rid of somebody or blame somebody, blame me. But I'm here to solve the problem. Let's move forward.

    Hayley Rodd:

    Wow.

    Tony Camacho:

    She wouldn't tell. And that was to me was one of the most outstanding moments I've ever seen. And she was at that point actually using Easy Agile that wasn't a financial institution in the United States. I would let you know that teachers use it, figure it out. And she basically showed the board and just went through everything and did that. That was leadership. That was leadership. And generally your teams will follow leadership and they will suddenly step up and you'll see that that's what people who want to stand up. Now, not everybody wants to do that. Some people want to just be team members and that's okay. That is perfectly okay, but the thing that's not okay is that if they don't have trust, right? And to me, that's the biggest thing. When you have people who are resisting change or siloed in their world, they suddenly realize if you can get them to open up it's really, they're just telling you, I don't feel safe.

    I've been doing this all my life. I'm great at it and now you're asking me to do this. And you need to somehow get them to get the feel that they are bringing something of value. They are helping you move forward. And you're meeting them halfway if you have to. But yeah, that's the biggest problem I've ever seen that we've always, it always comes down to the human being in that. The rest of it, you can always come, you can always change that. But there's some of the things that you also have to do. I think that some people run into Hayley that I think me and you live in our world as we're moving up is sometimes we are, there's an ambiguity of the things that we have to do. And I've seen you do that, people in our roles will have suddenly, even if it isn't part of our role, will take it on and we have to learn. That's it. But yes.

    Hayley Rodd:

    Yeah, I think that, yeah, it's so true that the [inaudible 00:19:23] the psychological safety needs to be there. And I think back to so many teams that I've been a part of that it isn't there. So you have to feel like you got to lay your mark or put your mark on something and show your value. Because if you're not showing your value, then you get questioned. And so I think that that's such a common thing that I see in teams and it actually creates, not a camaraderie, but a competition between teammates and it breeds the wrong environment. So it's just really interesting. One thing that I did want to touch on that you spoke a lot about a couple of questions ago was respect and making sure that teams have respect for each other. How does a team member show respect for their teammates? What are some really good examples of respect and how can we display it or embody it or enact on it as team members?

    Tony Camacho:

    So let me show you a lack of respect right now. Yeah. Hayley, we're talking about this.

    Hayley Rodd:

    Looking off camera, avoiding me. Yeah.

    Tony Camacho:

    One of the main things was to really to learn to listen. Sit down, believe it or not, I found the best thing is sometimes taking a deep breath, listening, not responding, recognizing what that person may be feeling and going through at that moment because it's hard what we do. It's half art and it's half science. Let them learn that making a mistake is not a failure, it's a learning moment. Have that discussion there. Take their concerns real. So it's funny because you just made me think of something. That's one thing where I could show respect to my teammates would be as a scrum master, if I was a scrum master, hold effective retros. Really listen to what they're saying in the retros, report back on the things that you said you're going to improve in the retros. So we said these are the three things we're going to improve on or these are things that are assigned to me.

    Make it real. Make it a story. Show it on the board and say, "This is where we're going. This is what's happening. This is what I'm blocked by. Can somebody help me?" But I am working this for you. Get them, really be sincere. I don't mean buying pizza or bring a lot of scrum masters will bring pizza and donuts to the office. No, it's make their lives really better. Be that advocate up for them. And if you're a teammate, be an advocate for each other and be sincere. Have the bravery to stand up and say that's not a fair assessment. But the biggest thing is to really listen. Because a lot of times when somebody's saying something to me, I'll make it personal. Me, I have sometimes have, I know I'm feeling uncomfortable, but I cannot explain why. And just having you there, looking at me and talking and going through it, I suddenly realize it may have been something different and I want to hear your ideas.

    But I would have to, if I wanted to show myself to help that teammate, I also got to make myself vulnerable. If you're coming to me, I should share, but I should active listen, right? And really I respect your different perspective. It's okay. We all have different perspectives. Problem I find is that in ourworld, that we're moving so fast sometimes we don't stop to listen. We lack patience. We're moving too fast. So I'll share one for you that I'll be sincere. I had something medically came up and I was being a little abrasive with the team. So finally I called a meeting with our team and they saw me cry. I was okay with it. I was like, "I had no reason to be like this. You guys were showing me love, you were showing me respect, you're backing me up, helping me with my work. And I was still being utterly terrible."

    And it hurt me. It hurt that I was doing that, but I needed them to see me and I needed them to listen to me, give me that second to get it off my chest. And in the end I started crying. A 60-year-old man crying in a meeting going, "I shouldn't have done that to you. That was wrong." And it wasn't contrived. Some of the people there were 20 year old people on my team and they were in tears. And it was because they felt, they told me after this, they felt my pain that I was in, because I wanted to help. It's the most frustrating thing. To your point before, how do I feel? I wanted to help. I wanted to be there and I couldn't. Physically, I wasn't there. My mind was all over the place and I was being rude, being blunt, and I could use some other terms. Please don't. But that's really the main thing for me was it's really simple what we do. I just listen and just show respect for other people. And sometimes we forget.

    Hayley Rodd:

    I think that so many of the messages that you are talking about are not just for developer teams, they're for every team, every team in every walk of life. I think that they're just so fundamental to successful human relationships, whether it be personal or professional, I think so. I think there's just so many good messages. One thing that I wanted to touch on was that you're talking about active listening and when you think back on your career, and maybe this is totally off script, but when you think back on your career, how have you become a better active listener over the years? How have you improved that skill? As you said, you're an extrovert, you want to get in there, you want to fix the problem. How do you get better at that?

    Tony Camacho:

    I had some very, very smart people that put up with me, listened to me, and then had the courage to approach me after and teach me and teach me and didn't embarrass me in front of anybody. Did it in a manner that they said, "Do you think maybe this could have been better Tony?" As I said, I'm 61 and still I'm an extrovert and I still have high energy and I still make mistakes. As I tell everybody, every day I wake up, I make a mistake, I just got up. But I could have stayed in bed longer. But also the thing that I've learned, and it's just by the nature of getting older, it's not the age part of it. It was watching people come up trying to do the same thing I did that I failed at and I was an instructor for Microsoft for a long time.

    And seeing how, because to me seeing how a person's minds works is amazing. So what happens is I'll just... You know what I tried that, it didn't work for me, but I will say after class with you to show it to me again because maybe you solved it. I'm not that arrogant. And the nature of our business is that I find this, that the more you learn, the more you realize how little you know. That was the biggest thing that opened my eyes. Now it's like, oh my Lord. You meet somebody like John Kern, you meet somebody like Sophia Chaley who come from different perspectives, brilliant people, and you suddenly see that they happen to do things slightly different and you just watch them and you're like, "Wow." And the thing that I love about our job, which I guess you must love, everywhere we go, every team we work with, it's different. It's different.

    Everybody always asks me, how do you do that. And I'll tell them, "Look, I will share with you the ways I did it. I have a varied background. I've always been consulting." I've done the ATM space, I did for space enabled warfare, I've done for health industry, everyone's been different. Someone from government regulation, but most of the time different human beings. So I have a saying, I've earned every scar in my back, their minds. I've learned people, you have to give people the chance to have their scars. Yes, it may be pain, I'm not saying fail, I won't let them fail. But sometimes people want to do something. So that's the way I would do it. Let them do it. And I just watched and learned that what happened was as I went in and the more I learned and I suddenly realized how little I know, I was like, I started with FORTRAN, I used to work in the dead 28.

    And then you start working your way up and you start realizing, "Wow, I don't know as much as I thought I know." And I had the luck of running into working at Microsoft and having the pleasure of meeting Bill Gates. Now, no matter what you say about Bill Gates, because a lot of people do say some crazy things and some of them may be true or may not. But the one thing you can't take away from him is you go into a room with him and you suddenly see how he puts all these ideas together and comes up with a bigger picture. You suddenly realize, "Wow, people tell me I'm really smart, not that smart." And then you learn, humility is a good thing.

    Hayley Rodd:

    Yeah, I think humility is just such an important asset to have and to try and grow on because leaving your ego at the door and being open to learn from other people and not think that everything is definitely a life lesson that sometimes you need to go through. And some people go through it and still don't take away the life lesson. So yeah, I think it's so interesting. I guess we don't have too much longer left, but I wanted to touch on thinking about it from an ROI perspective. How important is team alignment from a return on investment? What do you gain from a business perspective when you have an aligned team?

    Tony Camacho:

    So I'm going to use a term that I dislike and Hayley, you can smack me the next time we meet. But I'm trying to use it as, I don't because it's effective resource utilization, right? But I'm not referring to human beings to that point because it may be human beings. The problem is that's a large market. But as Agile people I won't refer to you as a resource, I refer to you as a fellow human being, you are a partner on my team. You're my teammate. You're not a piece of wood. But that is unfortunately a term that is used. And we will have effective utilization, we'll have common goals across our organization. If you're using any of the message less, bad, safe, pick it, you start focusing on your value streams. You should have improved product quality because we have the same cadence. We're putting things out there and we're having the same views there.

    You'll have I think better customer satisfaction and loyalty. They start seeing your product quality going up, being consistent, look and feel and hopefully you are delivering what they want. When you have your teams aligned, you're much more adaptable. Hayley, your team's got capacity? I don't. We don't have capacity to do this. Do you have capacity? Yes I do. Or we find someone or we break it down together and we present an idea to our partners. That's the things I like and I think in the end you have reduced risks at that point.

    Also, I think that the thing that they have in is that it's indirect, but nobody knows about. Nobody really talks about it is that if I was upper management C-suite, when we start doing this and we're having the teams aligned, first of all, your teams become safer, your teams feel more comfortable, they're working with the same people. They start becoming very effective and they start producing ideas. They're the knowledge workers. They know this better than anybody else and then they feel empowered to share ideas. The places that I thought that I had the best teams was once they asked... Well, and I got it, I don't know how, I was running a train and they asked to talk to the CTO and all they wanted to do was to talk to the CTO and make that person human. They asked her what she did in a previous job. Amazing. She worked as a factory worker and she also worked in construction. She used to drive, one of the things, nobody would've believed this. And what happened was they started sharing ideas with her and she embraced them. You know what that did to the team, the teams all, they were like, now that's out there, that's ours. Look at that. That was ours. I mean ownership, it's unbelievable.

    And unfortunately we are working on a capitalist market, which is fine, that's who we are. I mean we're in IT, it's a return on investment. Return on investment in the end, you start seeing much more efficient use of your money, much more efficient use of your dollars. Also, I would also imagine for the people above who are in the C-suite, they suddenly realize that the organization is going in the same direction. I think psychologically they feel that we now I have this team behind me pushing towards the same goal where a lot of times, every time I do an agile transformation, the first thing we always hear is we know they're working. We don't know what they're working on. And that's where something like Easy Agile bridges that and then you can use that information to go further. And that's wonderful because then at that point, everybody's on the same page. So you're a team now all the way from top to bottom. As opposed to I'm going to my team at work and that's it. So it's just really about return on investment, making sure that we are hitting our customers with everything we got. And I don't mean in a bad way, but we're delivering for our customers with everything we got. It's now efficiency, right? And that's it. That's about it.

    Hayley Rodd:

    Yeah, that's so powerful. I think it sort of nicely ties everything together because we've talked about a lot of things in the last half hour or so. And I think that at the end of the day, if you can get team alignment, just as you said, there's this ROI that can really shine through and it's a powerful thing for the whole organization to get right and to see the fruits of that work. So one last thing. Can you share your perspective on PI planning? I know you just mentioned safe a little bit for being the initial launchpad for team alignment.

    Tony Camacho:

    I love it. You have everybody in the room, you get to meet the people, you start making those connections to people. You start seeing them as human beings, not as this email or this text that you're sending across that you're going through there. So could I share one real experience from that? That's a PI planning house.

    Hayley Rodd:

    Please

    Tony Camacho:

    Do. So when I was working at Microsoft, I work for product quality online, which I know right now, considering the problems Microsoft is having, you're pretty much going now, "You suck Tony."

    Hayley Rodd:

    Never.

    Tony Camacho:

    No, we had our people distributed all over the world. And what was happening was that when I would talk to my short teams, I would ask them, and I was being facetious at a point because I just couldn't get the true answer was I would ask him, can you build the Twin Towers by tomorrow? And the answer would inadvertently be yes. Next day would come. Obviously you can't do the twin towers overnight. Ask them again, will you get it by next week? The answer would be yes. And they were feel for all of that. So when we had the PI planning, we did.

    Microsoft went, got a hotel room in Seattle, a hotel room, a hotel in Seattle, rang our offshore teams. And then when they got to see me in person, they suddenly realized that I wasn't telling them I need the twin towers by tomorrow. I really wanted them to tell me when they could get me the twin towers. And I would defend it because they saw me right there in PI planning, defending, saying, "No, this is not possible." And when they saw me doing that, suddenly it was like the sky's open, sun's came through and now I was getting true answers. And what happened was it gave him an opportunity. And I realized that guys, you keep hearing me as sermon. It's always about the human beings, it's about those connections. It's about seeing the people. It's hard. It's two days of a lot of work. But once you get that work done, you come out of there a line, sharp direction. We know what our north is, now, do we know exactly where our true north is? As an agile team, we shouldn't, right? We should be refining it as we get there.

    Find out exactly. But we know more or less where the direction is. We more or less know we're all on the same page. We all know that what we have to deliver to make this work out what other people have to deliver for us or we have to deliver for other people. So we suddenly feel part of something bigger. Bigger, right? We are now talking to the, if you're a developer or an engineer, software engineer, you're starting to see the power brokers and why they're doing this. You get the chance to ask them questions. What more could you ask for, right? I finally get to see the people who are making the decisions and I can ask them why. And they can tell me what the business value is and I can make the argument to them that maybe I don't think that's as much business value or we need to fix these things first before we can get that right and move our way on. What more could I ask for? I have an opportunity to make my case and I get to see the other people I'm working with. It becomes, when you're dealing with 125 people and you're on a train, you will become family.

    We spend more hours sometimes with these people than we do with our family members at times. And it also gives you a sense of... Besides trust, a sense of a safety. You know it's not just you, it's all of us. So the saying that usually I see that the better executive say, I heard that in one PI planning, you fail, I fail. I fail, you fail. My job is to keep you employed. Your job is to keep me employed and to keep this company together. It's synergy, right? So it's amazing.

    Hayley Rodd:

    Beautiful.

    Tony Camacho:

    Yeah, I know. I'm all about the human. Sorry.

    Hayley Rodd:

    No, I am right there with you. I'm so glad that we got to have this conversation. We've talked a lot over the little while and every time we meet, I'm flabbergasted by your energy and your authenticity. And I think that this conversation that really shown true, so thank you Tony for taking the time to be with us. I'm going to say goodbye to all our listeners. I'm going to say another big thank you to Tony. So Tony is part of aligned agility and that is part of The Adaptivist Group. And yeah, thanks Tony for being here with us and thank you for everyone who has tuned in and listened to this episode of the Easy Agile Podcast. Thank you.

  • Podcast

    Easy Agile Podcast Ep.17 Defining a product manager: The idea of a shared brain

    In this episode, I was joined by Sherif Mansour - Distinguished Product Manager at Atlassian.

    We spoke about styles of product management and the traits that make a great product manager. Before exploring the idea of a shared brain and the role of a product engineer.

    Sherif has been in software development for over 15 years. During his time at Atlassian, he was responsible for Confluence, a popular content collaboration tool for teams.

    Most recently, Sherif spends most of his days trying to solve problems across all of Atlassian’s cloud products. Sherif also played a key role in developing new products at Atlassian such as Stride, Team Calendars and Confluence Questions. Sherif thinks building simple products is hard and so is writing a simple, short bio.

    Hope you enjoy the episode as much as I did. Thanks for a great conversation Sherif.

  • Podcast

    Easy Agile Podcast Ep.28 Team23! + the world of work

    Dave Elkan, Co-Founder and Co-CEO of Easy Agile is joined by Jean-Philippe Comeau Principal Customer Success Advocate at Adaptavist.

    "Hearing from JP is a sure-fire way to get excited about Atlassian Team '23. We spoke about where we are hoping to see conversations focus + more."

    JP is passionate about teamwork, meeting new people, presentations of all kinds - loves a microphone and a captive audience, new technologies and most of all problem-solving.

    In this episode, JP and Dave are talking about one of the most anticipated events in the tech calendar - Atlassian’s Team23! They’re talking about what to expect, tips for first timers and what they’re hoping to take away from the event.

    They also dive into the future of work and the significance of coming together as a team.

    We hope you enjoy the episode!

    Transcript:

    Dave Elkan:

    Hi, all, and welcome to the Easy Agile Podcast. My name is Dave Elkan and I'm co-founder and co-CEO here at Easy Agile. 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 State Islander and First Nations people joining us today. Today I am joined by Jean-Philippe Comeau or JP. JP is the principal customer success advocate at Adaptavist and is passionate about teamwork, meeting new people, presentations of all kinds, loves a microphone and a captive audience, this podcast definitely fits that mold, new technologies, and most of all, problem-solving. JP, thanks so much for being with us today.

    Jean-Philippe Comeau:

    Thanks for inviting me.

    Dave Elkan:

    Hey, no worries. It's great to have you on. We want to take some time today just to talk through Atlassian Team '23. The ecosystem is gearing up for one of the biggest events of the calendar and the ultimate event for modern teamwork. You've been to a few Atlassian Team events before and last year being the first one back in a while. Quebec to Las Vegas is quiet a gear change. What are your tips for people attending Team for the first time?

    Jean-Philippe Comeau:

    Ooh, yeah, that's a good question. I mean, yeah, Teams to me is a massive event. It's a beautiful moment to actually take in everything that has happened in last year for Atlassian. What I mean by that is actually more and more what's happening with Atlassian is actually what's happening in the world of work. So I think it's just a great time to reassess where you're at. So for me, it's about planning out the main things you want to hit and don't overcrowd your schedule. That's a mistake I made the first time was just I wanted to see the most of everything and I was like, "Yeah, I can absolutely do back to back to back. It's going to be fine. I'll be walking from one thing to another." Truth is after talk, you'll have some questions. Some things will popped-up. "Oh, that's interesting. I could maybe explore that."

    You're going to want to do maybe some floor hunting, which is like, hey, looking through the partners. Maybe you've heard about something like an app that you really want to go look at or something like that. So, that's always going to happen and then you're going to miss that next talk. So make sure that what you highlight is really things you want to see and plan according to that. That to me is the number one thing. Don't try to do it all. Do what you feel is really, really important than the rest. Try to make it work because it's going to be a lot of walking, a lot of listening, a lot of talking. The second thing which I remind everybody is to hydrate, get a bottle of water. There's going to be plenty over there, but everybody's going to have their own branded bottle of water, so don't worry about having one or not, but get one and just hydrate. I mean, we all get very busy during the day and we all know how the nights can go, so keep drinking some water. Yeah, those are my two tips.

    Dave Elkan:

    That's great advice. I think hydration is certainly something to consider. I remember particularly a wall of donuts at one point distracting me from good habits like that. So yeah, it's really important to make sure you've got the basics in line. What are you most looking forward to from the lineup at Team '23?

    Jean-Philippe Comeau:

    Yeah. I mean, every year the keynotes are what's going to hit the most. Obviously, getting a chance to hear James Cameron talk is going to be very, very interesting. I think especially in the year of Avatar 2 is just great timing, obviously probably planned. He's probably on a tour, but it's going to be really great to hear some stories of how that movie came about. It's been a long time in the making, probably the closest thing we got to really long development on a film. It feels like a long software development cycle thing. That's a very long time. And then hearing Van talk about some of the things that he's seeing in today's world. Van Joseph, I believe, is the name of the second talker, and remember seeing him a lot on the CNN broadcast and stuff during the elections and the impact that he brought to the whole broadcast was quite something. It'd be very interesting to hear them talk.

    And then as far as maybe not the big ticket items, really interested to... I think this is the year where the practices on the different tracks that Atlassian usually promotes, I think this is the year what they really start to hit. What I mean by that is I think before this year, so when you look at last year's Team and then before that, tracks were kind of like wishy-washy. Now, they actually have the products to back them. I think JSM's in a very, very good spot. I think their agile tooling is in a very good spot. I think their DevOps, which is what I expect, is going to be pushed the most, or DevOps tooling with the Jira product discovery and all their Point A stuff is got to be where it's at. So I think you're going to get really good talks on those practices. I think that's going to be the year where the tracks actually make a ton of sense and are very valuable to people.

    Dave Elkan:

    Absolutely. Thanks for sharing. It's really interesting. Yourself, you're a Canadian and James Cameron is a Canadian and he's talking about creating the impossible, and I think that's a theme that's coming through and what Atlassian is promoting and bringing that through. It's really interesting to see or hear you talk about the both building movies and media and CNN, the reference there, and how that can apply with a strongly software development-based audience. It's really interesting to see that building a movie is a very much a waterfall process in that you have this huge deliverable at the end, but I know that there are Pixar, for example, use this concept of Demo Trusts, we call them, or the Pixar Demo Trust. Yeah. So essentially you can test along the way as you go before you deliver this huge thing. It's really intriguing to think what we're going to hear from James in regards to how he builds these amazing projects.

    Jean-Philippe Comeau:

    Yeah, I think you're spot on. So I'm actually a huge Marvel fan. I don't have my book with me, but the Creativity, Inc. is a book that I love by Ed Catmull and how they built Pixar as a business, as a delivery team, not just about the movie side of it, the creative side of it, but how do you bring creativity into a more structured world that is the corporate world kind of thing, which they're now a part of? So, very interesting that you bring that up because I'm very fascinated by their process as well. I think they were the pioneers in the movie-making business or industry into bringing the agile methodologies or thinking to movie-making.

    Now, what would happen historically in movies? Okay. So you don't know this, but my background is actually enacting. So when I started, when I studied, when I was a young lad, young adult, let's put it that way, I wanted to be an actor and then things changed. Obviously, I am not a prolific actor. So I'm very, very passionate about the movie-making industry. Movies historically has always been about you shoot, you shoot, you shoot, to develop, develop, develop, and then at the end, you cut it. So you make mistakes. So like we said, very, very waterfally. I think now that technology is almost like 50 to 60% of a movie now more days... If you look at Marvel movies and all that, you could argue it's 50 to 60% is going to be computer-generated, which can be a bad or good thing. Now, that I'm not going to get into that debate.

    The nature of previz and all the animation work that goes behind it makes the process more agile, meaning that what they're going to do is they're going to build for a week and then they're going to review the film that's been made and then they're going to correct and do it again, right? So already you got your feedback loop going. You got your process. You got your sprints going. I can map all that out to some agile processes and I wouldn't be surprised that you're looking at something that are looking to scale up. You could even argue what are you guys going to do for your scaling methodologies? There's a lot of things that are very interesting.

    I think going back to our first point, sorry, I really went on a tangent here, but going back to Avatar, when you have such a long cycle and you have a movie that's built, that one is heavily computer-generated. I mean, every actor has stuff on their face and they're acting in a blank studio. Now you're talking about agile processes because if you're building hours and hours and hours of work and you're just building and building and building and never review, I can't... Maybe James will say that's how they did it, and I'll be like, "Well, you guys were... It's very difficult. You made your life very, very difficult." But it'd be very interesting to hear because I cannot imagine them not going into some type of an agile way of building this movie.

    Dave Elkan:

    Oh, of course. I think that if you imagine the cutting room floor, it's an old adage and literally they used to cut the film and they'd leave it on the floor as that's something we're not doing anymore. And so, I dare say that there's a vast amount of film which is thrown away and redone. I feel that if we could see past that to this beautiful thing that they're doing behind the scenes, which is testing and iterating on their shots, it's actually quite a simple concept to apply these agile processes to filmmaking. It's just at the end you have got this big bang, same in game production. When you produce a game, you cut back. People do early access, which is fantastic. You can't early access a movie.

    Jean-Philippe Comeau:

    No, exactly. Yeah.

    Dave Elkan:

    Yeah. Going back to Pixar, that reference, I actually made the mistake. It's not actually the Demo Trust. So this is the Playbook by Atlassian. There's a play called Demo Trust, but it's the Brains Trust and it's bringing together the team to talk through does this fulfill the vision of Pixar? Does this make Pixar Pixar? And helping the team understand, so directors get that ingrained Pixarness through that process. So yeah, there's a whole team behind the scenes here. There's not one person who's just driving this at the director level. There's actually a whole team of people collaborating on this movie. So I'm really intrigued to hear that from James to hear how the teamwork comes out.

    Jean-Philippe Comeau:

    Yeah. I think when you look at a movie like Avatar, again, another thing that we don't think about is the connecting remote teams, which is a big, big part of what we do in 2023 is connecting remote teams so that they feel they're working on one project. When you have a movie like Avatar, your VFX is going to be somewhere. Your actors are going to be another place. And then you're going to have music and sound's going to be somewhere else. Your editors are probably going to be somewhere else. And so, there's a lot of remote work that you do. How do you bring all that together?

    I remember watching the old documentaries around the Lord of the Rings movies, and they were literally flying people in and out with the actual roll of films because they were so afraid that people would steal them and so that they wouldn't put it on the internet and they would actually carry them around. So they had to fly from London to New Zealand to... It's kind of nuts when you think about it in 2023. Really, you had to take a 10-hour flight just to get your film across? It's probably easier also with the data, just the bandwidth and everything. So I think that's also going to be an interesting part is how did you connect teams?

    You brought up a great point around the Pixar way or that's how they call it, the Pixar way. When you think about that, there's some really, really cool ideas behind bringing a team together and rallying them around one project. I think as teams get more remote and distanced from products and things that they're working on, and I do it myself at work. Things become generic. At some point, you're just doing the same thing over and over again. You lose touch a little bit with the work that you do. I think it's a beautiful thing to be able to rally a team around a project and say like, "Do you believe in this project? I believe in this project. Do you believe in this project?" And making sure the team does and if they don't, why don't you? What's preventing you from that? I think there's a lot of good conversations, sorry, that can come from that. Yeah.

    Dave Elkan:

    Absolutely. So yeah, you talk about going more remote. Is that a trend you're seeing, that we're continuing to see more and more teams go remote, or are we seeing a reversal of that to some extent?

    Jean-Philippe Comeau:

    It depends on what sphere you're working with, or in my position, I get to touch everything. I tend to gravitate towards the more creative teams of gaming and software development and stuff. I do work with banks. I do work with, well, corporate America, the classic suit and tie kind of places, everything. I see everything. There is absolutely out right now a battle of old versus new, old ways of working, new ways of working. There's a huge clash happening. I to this day do not know who's going to win, because even the big Silicon Valleys, I mean, we are all seeing what's happening with Apple and them putting mandatory office dates and stuff like that. You see that from an executive that is leading maybe one of the more bleeding edge companies in the world, but he's still an old school vibe of creativity.

    I hate bringing it back to Pixar. I'm going to bring it back to Pixar. They have such a great office. So like I said, I'm very fascinated about what they do. They call it unplanned creativity. They truly believe that unplanned creativity happens in the office, and when you have unplanned meetings, unplanned interactions. So one of the things that they did, it's now very common, but when I was 14 years old and I was reading about them, I was like, "Oh my God, these are such cool things to do," they were doing those ping-pong places and activities and games to get people to play together and start talking about what they were doing.

    And then all of a sudden you got an engineer talking to a VFX artist that's talking to a 3D or conceptual artist, that's like they would never meet in a meeting or anything like that. But because they're playing ping-pong and throwing ideas around and all of a sudden they're like, "Hey, maybe we could build this thing. That'd be amazing." Because the artist saying, "Well, now I could do clouds this way. Yeah. Nuts, I could create clouds that look like this." Then the engineer goes, "Well, you can just tweak a little bit of things."

    Anyways, so I think there's this old school mentality at this. It's a question I've asked myself in our Slacks and where we talk about work. I don't know what the future is for unplanned creativity. I don't know how you recreate that in a virtual world. I think it's a big problem that some software companies have tackled with some tools. I don't know how you force someone to sit behind a computer and do something that's unplanned. How do I stumble across some... I don't know. But yeah, I think there's a bit of that in the old school mentality. I need people in an office so that they can meet and they can interact together. I still struggle to find where they're wrong, let's put it that way. I don't know where they're wrong about that theory of when you're with someone, when you're with people things happen in a different way.

    Dave Elkan:

    I can't agree more. I think that if I have any perspective on this, it's that there is not... Often, it's not a black and white or a zero sum kind of game. It's a combination of things that will occur and that will move forward for better or for worse. You can look back in history to Bell Labs and the creation of the semiconductor and the way that the building was designed essentially to allow people to walk past and have cross-collaboration and cross-functional conversations. Have you ever considered that the unplanned creativity that Pixar was talking about was actually planned-unplanned creativity, so they made these spaces on purpose? How can we make things on purpose to have things unknown to us happen?

    Jean-Philippe Comeau:

    Yeah. Yeah. Actually, you're absolutely right. I mean, yeah, they built the Pixar offices this way because of that. To me, that is the secret. If someone finds it, it's like the caramel milk or whatever, just bottle it up and sell it to people, I guess. I don't know. I have no idea what the answer is. I've looked and it's... There's an app out there. I can't remember the name of the app, but you're like a 2D sprite and it looks like an NES game and you're moving around from places to places. You can decorate your office. It's got this vibe of Animal Crossing, which is a game by Nintendo where you can just create stuff and people can visit your island and all that.

    You can do that with your office space and then you can create a common area where people walking. When you look at it in a video, it's brilliant. Great, I can actually be in the office without being in the office. It has this whole technology of proximity. So if you're having a conversation with someone in an open area, people could walk by and hear what you're saying and join in. Beautiful technology, doesn't work with the humans when you really think about it. Why would I go online to walk around an office to go talk? I'll ping you on Slack, it'll be easier. All right. I don't need to walk through your office. So it's like I don't know what the secret is.

    Yeah, you're right, it is planned in a way. I think we do that. I don't know for you guys at Easy Agile, how you do it. In Adaptavist, we do like to travel with teams. So whenever we do things, even if it's customer work or if we're going for an event or something, we try to make it a point to make it about also us and what we do. So we rarely traveled alone. If I'm going to a customer, we're trying to get two consultants in there, or what I'm trying to say is bring more people. It's a point, I think, Adaptavist is trying to make and I think that's what Simon, our CEO, is trying to make is use these opportunities to be with people. I think it's a beautiful thing, but it's one of the myriad of solutions. I don't know. I really don't know. What do you think? What are your thoughts on this?

    Dave Elkan:

    Oh, I can share how we work at Easy Agile. So here I am today in the office. This is a great place for me to do this recording. We have a room for about 50 people here in the office in Wollongong, south of Sydney. We have about 10 to 15 who usually arrive on a daily basis, and that's great. We don't mind. We love people working from home and working away, which is more convenient and relaxing for them. At the same time, we do have quarterly plan, like planning sessions that we go to. We have Advanced Easy Agile every quarter. We come together in person. We've strategically ensured that we hire in a way so that's possible, so people aren't flying across vast sways of ocean to get to this conversation. In a way, it's planned-unplanned. So we do our planning ahead of time.

    When we come for Advanced Easy Agile, we'll have something that we want to either upskill the team with or whatever, and then we'll have some team bonding where people can choose from a range of different activities they want to do together. And so, for us, it's more about getting together in person because we know that's really valuable to both build an understanding of each other as a team and to build that rapport. It can't be done over Zoom to an extent. So, absolutely, our business runs entirely in a remote-friendly way and we don't rely on people to be in person, in sync in person to move forward. However, we do see there's a great value there. So we try to live in both worlds and we get the benefit from both of them. Yeah. And so, that's one thing that can work. It's not for everybody. If you have a truly distributed global business, it's not exactly easy or affordable to bring everybody together on a quarterly basis.

    Jean-Philippe Comeau:

    Yeah. I think it's beautiful though. So I've been in Adaptavist for close to six... I'm on my sixth year now and we used to be able to do... We didn't do quarterly. We did a yearly thing at the end of the year where everybody would get together. We called it Winter Con for the last two years, which I actually loved the idea, which was very much we could pitch ideas of what we wanted to talk about. It could be about work, could be about customers, could be about last year, whatever you wanted to talk about, could be about yourself, could be about a cool thing you did this year, whatever. We had a voting system, but really pretty much anyone that said any, you could get in.

    You could just walk around and it was literally a conference center. We'd set up some rooms and you could walk in, look at a presentation, literally like Teams or whatever. It was the best experience every time that we did that. I love these because there's value. There's an ROI in having everybody learning and upskilling and breaking down these silos of, "Hey, I never worked with marketing, but here's an hour talk around something we did in marketing. I really want to join," and all these things. That's great. There was also the unplanned ROI, where you were coming out of there with multiple ideas of like, "Oh, I could explore this. We could explore that. I got this meeting set in Jan now that whenever I come back in January, we're going to be talking about this thing that we talked about for cloud migrations." All that was happening at Winter Con.

    Now, we grew exponentially post-COVID, well, during and post. So while COVID was happening and all of a sudden everybody wanted work. And then as companies that were remote, I think a lot of the companies that were remote grew during COVID versus because companies that were local or anything, they slowly diluted down a little bit, let's put it that way. As we grew, we can't support that anymore as a one-time thing where you'd have... We're close to a thousand now. There's a lot of people to move and a lot of conferences, a lot of conference rooms and presentations and stuff that we just can't accommodate. So, I miss it a lot. We've been doing it remotely, but like you said, it's not the same to go on a Zoom call.

    I remember sitting down in these presentations and you're sitting down next to people that someone from Arkansas, someone from Cambridge, and you start talking. Yeah, you're listening to conference, but we all know what happens when you're listening to a presentation. You start talking like, "Yeah, that's an interesting idea. What did you do last weekend?" You start talking. Those are things you can't do on Zoom. You can't really reproduce that on Zoom. It's not going to happen really and I miss that dearly. I don't know what the solution is when you have these kind of global distribution. I mean, I guess you do in a smaller way, maybe all of North America meet up or things like that, but it's just not the same, not the same at all. I think it's beautiful that you guys can still do these because everybody's close by. I think it's really nice.

    Dave Elkan:

    Oh, thanks. Yeah, it's something we're hoping to hold onto as long as we can. We understand that these things don't scale. At one point, we'll have to break it into different events so that people can have, I think, a higher level of involvement in that. If you have too many people at the same time, it can be just a bit read only, the way I see it. It's as if to seek participant.

    Jean-Philippe Comeau:

    That's nice. Yeah. Yeah, I like that. Yeah. Yeah, you're right.

    Dave Elkan:

    So I'd love to just quickly touch back on Atlassian Team '23.

    Jean-Philippe Comeau:

    I'm sorry.

    Dave Elkan:

    You did mention at the beginning... That's all right. We'll get there. There's these new apps, especially in the DevOps tooling space that Atlassian's working on, so Discovery. Can you just talk to me a little bit more about what you see there and why that's coming to fruition now?

    Jean-Philippe Comeau:

    Yeah, I think it's all about cloud. I'll be the first to say that big fan of data center, big fan of on-prem. That's how I learned the Atlassian tool set. So, a little skeptical when cloud came about. As it grew and it got better, it got better, that was great. I think it's now at a mature spot where the Point A program, which is where all of these tools are coming out of, so the product Discovery, Atlas and all that, those are the fruits of cloud. That's because now that we have cloud, they can churn out products and try things and see if they stick or not. I think that's why I think this year is the year where I think the program is mature enough. Migration's ready. I mean, we're one year out of server end-of-life. I think we're finally in a place where we can actually talk about all these opportunities. Most of the people at the conference will be able to get value from it.

    I remember last year where talks were heavily around JSM and all the cool things it would do, but you still had a lot of people on server, still had a lot of people on data center. So it fell a little bit on deaf ears. A lot of people in the crowd were just like, "Yeah, it's not for me." Both keynotes were about that. So anyways, I think this year it's going to be better because of that, because everybody's bought in. I think it's right now because yeah, it's cloud. You can ship easier, faster. You can ship better. You can iterate better. You can get a product ready much, much quicker than if you're on-prem, and I think that's why you're seeing this blow up. I also think they're great ideas. Big fan of Atlas specifically. Big, big fan of Atlas.

    Dave Elkan:

    Yeah. Fantastic. So, how are your customers seeing the migration to cloud? On the larger end, is that something that they're open to? Is that something that they support?

    Jean-Philippe Comeau:

    Everybody is intrigued, I'll start there. Everybody's intrigued. Now, the level of interest depends on the industry and the size. When you have a massive... I'll use banks because to me, banks are kind of like countries. So if you look at a massive bank where you have 30, 40,000 users, usually they have solid infrastructures. They have solid administrators. They have teams that are kind of living off this. It's built its own economy, basically. It runs itself. When you go in there and you try to teach them about cloud and all the great things it'll do, they start asking questions that are very technical and they're very good. There's not really an answer in cloud for yet, and so it gets skittish. Whereas if I go to a 500,000 people organization and they start asking questions about cloud, and usually we have more answers for that. It's just easy, an easier conversation. They don't have the same worries or the same thing troubles on their mind than the admin of 40,000 people. It's just not the same reality that they're seeing.

    So I think for now, and I know Atlassian's making a big push into that enterprise space, I think for now you're going to see that growth. But as long as we don't have full autonomy of where our data is and how accessible that data is, it's going to be a problem, as long as FedRAMP isn't available to all, as long as all these different SOCs and compliances aren't available to all. These are very difficult because you've built an ecosystem around a lot of integrations and Easy Agile being to me, one of those integrations because their third-party app, however you want to look at it. Adaptavist has their own third-party app. So you have script runner and all that. We all have third-party apps. So Atlassian can't be like, "Oh, yeah, I'll make a blanket statement. We can do all these things." It's not really true. I'm like, "Hold up, you got to take into account all these different app partners out there that are doing their things and you can't put us all into one roof."I think they're victims of their success. What still making Atlassian great is the partner ecosystem, apps, solutions, sorry, everything, but it's also what's causing the adoption and the speed to which adoption of cloud is happening. It's making it slower than they would want to. I think that was maybe the misstep a little bit when everything got announced was like, "Oh, you guys do rely on these apps a lot." Yeah. A lot of our customers actually would say that the apps are even more important to them than the core. It's just a thing that you're seeing. So to go back to your question, depends on the complexity of the instance. The bigger the instance, usually the more complex it is. So if I go to over 10,000 users, it's going to be a very long conversation. Very, very long conversation.

    Dave Elkan:

    Yes, it is. It's funny that Atlassian did ship this and say, "Hey." Well, actually, there was a presumption that the apps were covered by SOC 2 or the like as well, and that was a missing... But it was this misunderstanding. But I say as a business owner going through SOC 2, it's a very rewarding and good process to go through. It's hard. We are doing it far earlier than Atlassian did in their own journey, but the sooner you do it, the easier it is. Ideally that as a smaller company, you have less things to worry about and the processes you put in place will be easier to maintain and monitor. So we're excited to really go down the SOC 2 path and to provide that peace of mind to our enterprise customers. So yeah, very good process to go through.

    Jean-Philippe Comeau:

    Yeah, you guys are going through it right now. Have you acquired it yet? Did you get your compliance yet or you're on your way to getting that?

    Dave Elkan:

    No, we're on the way to SOC 2 type 1 at the moment.

    Jean-Philippe Comeau:

    Wow. Nice.

    Dave Elkan:

    Yeah.

    Jean-Philippe Comeau:

    Yeah. Yeah. We got security group now in and they're handling all that. I'm not good with the compliances. I'll say it right now, right off the bat, I don't know them very well. I know they're like letters I would like to see next to every apps. That's what I know. I don't know how in depth the processes, but I know it's very involved to the point where you need to have a team dedicated to making that happen. So what have you guys seen so far? It's coming along great. What are some of the challenges that you've seen maybe? I'm just intrigued.

    Dave Elkan:

    Yeah. Oh, look, so our cloud apps are all architected in the same way, so they all use the same code base to an extent, like the deployment methodology. We haven't done any acquisitions which have bolted on to make that more complicated, so we're making the most of that situation. We've done a fair bit of work over the last quarter or so to put in all the checks and the controls around that deployment. The next thing is to really put in place the processes to ensure that our team understands how to deal with different situations and the like. So, that's something we're going to tackle in the next quarter. I'm excited to go through that and do a bit of a sprint with Nick, my co-founder and co-CEO, to really see how much we can get done in a period of time and really focus on that. I think that the benefit will be that we have a much more understood and clear way of running our business, which is obvious to our customers as well, which is a very good thing. I'm all in favor of it. Yeah.

    Jean-Philippe Comeau:

    Yeah, that's awesome. Yeah, I think we're seeing some of the similar things, but we did acquire a bunch of stuff and so that is making everything a bit more difficult, for sure.

    Dave Elkan:

    I can understand. That would be very tricky to try and bridge those gaps and to homogenize enough to be able to have a really clear statement going forward. Yeah. Okay. So we touched quickly on the Atlassian apps that they're bringing. Are there any apps in the marketplace that you have got an eye on that you'd love to go and talk to, of course, Easy Agile aside?

    Jean-Philippe Comeau:

    I mean, of course. Yeah. A big need that I'm noticing now in the market... I don't know if it's a secret or something, I should wait because I know Team '23, they're going to be doing some stuff and I'm really excited for them. So one of the things that we're noticing is... So backups, so enterprise support, basically. Right now, when you're on the cloud, most companies, again, in the 40,000 and plus have strong backup needs and they actually have requirements, laws, things that they need to abide by as far as how long they maintain data, how long they have backups of data and all that. Right now, the way that it's done in cloud isn't nice at all. You actually have to go into the UI. You get a backup. If your backup is large, it's going to take multiple days to process and you got to remember to... It's all manual. There's nothing that really automated.

    So, there is a growing market for these kinds of apps. I've been talking all that to these people at Revyz, R-E-V-Y-Z. What they do is they basically automate that process for you and they host your data. Right now, they only do it for a year, but it's still much better than what we're seeing out there. There's a lot of need for services like that, where they... Because I mean, part of the appeal of cloud is obviously hands off, don't have to worry about things anymore and Atlassian only guarantees backups for 21 days. So if you're an enterprise and you're looking for six months at least of data recovery, at least you're not going to get that. So by having a partner like Revyz or all these, there are other apps out there, I'm talking about Revyz specifically because I talk to them a bunch, but a lot of interesting things are happening.

    Also, what's amazing about these apps, what these developers have found, and once they've have that process, they now get access to the structure of the data and they've started building tools around that structure. So for instance, that app can actually restore projects and issues and custom fields and configurations. So you don't need to do a full restore. You can actually pick what you want to restore, which is brilliant. It's something that even in data center wasn't easy to do. You couldn't just say like, "Hey, give me that issue." You'd have to restore the snapshot, go into the system, find your stuff. Now being able to go into my UI and Jira, go into my backup app, go and look the issued I deleted by mistake, find it, restore it the same day, it has comments saying, "This was restored by revisits, so make sure blah, blah, blah, yada, yada, yada." It's just brilliant and I'm really excited to see that grow this year.

    Dave Elkan:

    That's amazing. Yeah, it's a really intriguing part of this piece that I've never really thought through that that's actually a really important part of running an enterprise, that you have those continuous backups. Yeah. Cool. Yeah, that's a great insight.

    Jean-Philippe Comeau:

    Yeah, it's going to be an interesting market to dive into because we've been asked, even as a service partner, "Can you deliver on this?" The truth is without an app, you can't. There's no real way for me to get a backup. I'd have to go into your instance every day. I don't think you want a consultant going into every day your instance, downloading a backup and throwing it. I'd rather spend my money elsewhere. So these apps are going to be very... I think they're going to be big and I'm really interested to see what happens with all these different ventures.

    Dave Elkan:

    Well, certainly, a booth I'll be popping by to see if we can include the Easy Agile data in that backup as well.

    Jean-Philippe Comeau:

    Yes, exactly. So they are looking at other app partners and seeing what they can do. So I think, yeah, absolutely, if you want to have a chat, they're great people.

    Dave Elkan:

    Beautiful. Thank you so much for your time today, JP. That's a wrap. Hey, is there anything else you wanted to touch on before we wrap up? Is there anything you are hoping to get away from the event, to take away from the event? Anything on the sidelines you're going to see when you're there?

    Jean-Philippe Comeau:

    I mean, obviously, App Day is going to be a big thing. Really excited to meet y'all in person, see everybody. So App Day is the time where I get really technical, get my hands dirty. I don't do that a lot these days. I miss it sometimes just sitting down and doing some good old admin work. So anyway, the App Days are usually when I really get back to the nitty-gritty of let's talk about script runner, where we're at now, and let's meet with Easy Agile, with Temple, with all these different app vendors and talk about what's coming up and what they're seeing. So really looking forward to that. But other than that, no, just looking to have a good time. I'll hopefully get some good social time as well at the evening. Like I said, we won't get ourselves half the fun is also after the events every day, so really looking forward to that, for sure, and meeting all my fellow ecosystem partners and talking to everybody and seeing what they've seen in the past year.

    Dave Elkan:

    Likewise. I'm at least 1,000% more excited now having talked to you about it. So thank you so much for taking the time today, JP, to talk through that and I can't wait to see you there.

    Jean-Philippe Comeau:

    Yeah, I can't wait to see you. Thanks for having me.

    Dave Elkan:

    No probs. Thanks, mate.