You're on your way to the next level! Join the Kudos program to earn points and save your progress.
Level 1: Seed
25 / 150 points
1 badge earned
Challenges come and go, but your rewards stay with you. Do more to earn more!
What goes around comes around! Share the love by gifting kudos to your peers.
Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!
Join now to unlock these features and more
“If it’s not written down, it does not exist.” This piece of wisdom belongs to an established software engineer, Philippe Kruchten, and as someone dealing in the software development industry, we get that. The consequences of a poorly documented project are devastating: you put an extra strain on a team, you waste time exploring the product, and you can’t agree on anything, inevitably contributing to more revisions and increasing the project cost.
While everybody already knows all of that, it’s important to keep in mind how we do it. Documenting shouldn’t feel like a burden or a chore. With Confluence, it’s easy: you have a familiar toolbar, logically structured and visually appealing templates, plenty of screen room, responsiveness, tons of macros, among other countless benefits.
And it’s not only about documenting software projects. For Redwerk, Confluence is a multifaceted solution allowing us to:
We’ve used Confluence almost since the very start of our operations, which is some 16 years ago. This journey was nothing but pleasure, so we’d like to share our go-to Confluence features and how we customized them to our needs. You can find our Jira tips for midsize services agencies here. Let’s dive right in!
We all strive to keep our files in order so that when a moment comes to retrieve some vital information, we know exactly where it is located. With Confluence Spaces, you don’t have to be a perfectionist or a control freak to easily navigate through your documentation.
As a midsize agency with about 70 professionals on board, we also believe in simplifying things rather than overcomplicating them; therefore, we grouped all of our written records into the following Space Categories:
Once again, the names of these Space Categories are pretty straightforward, so even if someone is not using Confluence daily, they’ll be able to get the needed information in no time.
For a software development agency, thorough documentation is key to avoiding any requirements misunderstanding and costly revisions. To be on the safe side, we document and communicate a lot. However, it doesn’t suffice to simply put all that data out there. For people to actually pay attention and read, each document must be digestible, with a proper layout and a decent visual appeal. The latter can be easily achieved with Confluence macros; the list is so extensive, we haven’t even tried them all.
The macros we use regularly are:
While Jira Dashboards are great for monitoring one’s workload and prioritizing urgent issues, you don’t want to overstuff it with minor tasks like talking to someone, sending a report before the end of the month, or reminding the client about the payment. You may also have an out-of-the-blue idea and need to write it down somewhere before you have time to give it a proper thought. These kinds of tasks are best handled in a Confluence personal space, which can be easily transformed into an individual dashboard.
We like to keep it simple; besides, overplanning to resolve a small task would entirely defeat its purpose. Our project managers usually create separate sections for each project they oversee, and within those sections - task lists assigned either to themselves or people they supervise with a deadline. There is nothing more satisfying than marking the checkboxes when those tasks get done.
While Confluence Search is pretty advanced by itself, it can be fine-tuned even further with Labels. One of our most popular labels is “meeting notes”. Although our workflows differ across departments, one thing we have in common is, of course, weekly meetings. We assume you have also encountered a situation when you urgently need a piece of information and you know for sure it was mentioned in one of the Meeting Notes. With Labels, our search results get super refined, which eases the lives of our project managers who document and contribute different types of content daily. Therefore, they don’t need to sift through large amounts of files since Labels narrow down the displayed results to a great extent.
The years of using Confluence as our primary documentation tool have proven its use cases are indeed diverse and flexible. For Redwerk, it’s been and still is a staple product, all because of its simplistic design, the abundance of handy features, continuous upgrades, and seamless integration with Jira. As an agile service agency, we are accountable for smooth project delivery, and the Jira & Confluence combo has successfully accommodated that need.