As more teams start using Rovo, I've been wondering whether our approach to Confluence content should change.
In the past, many of us tried to keep Confluence clean by archiving or deleting outdated pages. It made search results more relevant and reduced clutter.
Now I'm not so sure.
On one hand, outdated content can confuse users and AI if it isn't clearly marked. On the other hand, keeping historical documentation might give Rovo more context and help it provide better answers by understanding the evolution of projects, decisions, and processes.
I'm curious how other teams are approaching this.
Do you regularly archive or delete old Confluence pages?
Do you keep everything unless there is a compliance reason to remove it?
Have you changed your content strategy since adopting Rovo?
Have you noticed any difference in the quality of Rovo's answers depending on how much historical content is available?
I'd love to hear about your experience, best practices, or lessons learned.
I completely agree. I don't think the challenge is the amount of content, it's knowing which content can be trusted.
Historical pages are still valuable, but they shouldn't compete with the current source of truth. Simple signals like when a page was last reviewed, whether it has an owner, or if it's been superseded could help both people and Rovo make much better decisions.
I think content trust is going to become just as important as content search in the AI era.
I think it depends on the content on the page. For example, if the content is no longer true, accurate or relevant, then archiving makes sense. However, if it is content that is more like lessons learned for projects or like PIRs for post-incident management, as long as they're still relevant, I think keeping those even if on the older side, will help provide Rovo context and content to have that full-picture.
I feel like the more historical content available, it does take longer. For example, today I was asking a question about asset rest apis to get a single object, and I had a guide on how to use the import rest apis in my internal knowledge base. It had to read internal pages first even though they were related although it realized after a few seconds that it was not relevant at all. I guess it was not historical just related in the sense that the more pages you have the longer it will take.
I don't think the question is whether we should keep or delete old pages anymore. It's whether people (and AI) can tell which content they should trust.
We've found that older pages still have a lot of value because they explain why decisions were made, even if they're no longer the current way of doing things. That context can be really helpful for Rovo.
The real problem starts when an old page looks just as relevant as one that was reviewed last week. Without any indication of freshness, it's hard for both people and AI to know which one should be treated as the source of truth.
For me, it's becoming less about cleaning up Confluence and more about making the status of content obvious. Knowing when a page was last reviewed, who owns it, and whether it's still considered or still trusted feels much more important in an AI-driven world.
My philosophy is the past is the past, focus on the present and the future.
This means up to date documentation reflecting current state of the projects.
Historical information is contained in the issues in Jira if Rovo needs to access it. Comments inside issues explaining decisions taken etc. remain.
Obsolete documentation is archived the deleted. I consider obsolete any piece of information which doesn't hold any valuable information about the project (whether its past state or current state) and only creates noise.
I actually ask Rovo to audit Confluence spaces and give me a full plan for cleaning up spaces. It does a wonderful job in this respect. It retrieves the entire hierarchy of the space, finds duplicates, empty pages, pages with no readers and documentation which may be obsolete (I still need to check it visually myself to make sure it doesn't do mistakes here but it saves a lot of time).
Our company routinely faces document retention requirements, so it's baked in for us to create "archive" spaces where we file old documents. Any company working in a space that is heavily regulated should be keeping its documentation, even when the documentation is no longer relevant. You never know when you'll have to answer for why a situation was handled the way it was. OP brings an even greater reason to light - context! However much it costs to store data, commit to it and create a document retention plan. It's better to have it and not need it, than need it and not have it.
I try to ensure that my content stays relevant by updating when Atlassian and other SaaS providers send our their release notes and updates. I feel strongly that old / outdated content should be either updated or retired, but the how is interesting to me.
When a regulatory or contractual document retention limit is reached (such as for client information), deletion is fine (and maybe required). When something is no longer needed (e.g. documentation for a SaaS we no longer use) I archive.
We also use a custom status in Confluence to denote that content is Retired, which allows it to stay visible in a space but gives us a way to explicitly include or exclude it from Rovo's consideration. This one is handy when you have that sneaky feeling that something used to work one way and now doesn't seem to, or that a Client decision has done a 180.
Anne - "that sneaky feeling that something used to work one way and now doesn't" is the best description of this problem I've seen in this thread. And I think it points at the gap in every age- or status-based scheme: a page doesn't go wrong because time passed. It goes wrong because something else changed - a client decision does a 180, a system gets replaced, a setting flips. The page has no way of knowing that happened.
Your Retired status handles the pages you've already caught, and Michelle, a governance policy handles the cadence - both sensible. The part I haven't seen anyone solve with process alone is discovery: between two review cycles, which pages did last month's changes silently invalidate? The review finds them eventually, but "eventually" is exactly the window where a teammate (or an AI assistant) reads the stale version and acts on it.
Anne, your release-notes trigger is interesting because it's event-driven rather than calendar-driven - the vendor tells you something changed, and that prompts the review. Curious whether either of you has found an equivalent trigger for internal systems and decisions, where nobody sends you release notes. That's the case that keeps defeating us.
I created a policy for this. Hope this is helpful. I also have something similar for Jira projects (yes, I said projects).
We implemented these Guidelines BECAUSE of ROVO, to keep the content current. Confluence has also been billed as our company's internal Knowledge Base, so the need to keep things up to date and accurate is essential.
Recommended Learning For You
Level up your skills with Atlassian learning
Make AI a part of the team
Avoid common AI pitfalls and follow best practices to make AI work for your team.
Learning Path
Get the most out of Rovo
Learn how to use Rovo, Atlassian's AI-powered product, to find, learn, and act on information faster.
Use Rovo across your organization
As an Atlassian organization admin, learn the capabilities of Rovo and how to enable it across products.