What are some best practices for content reuse without adding plugins?

Question

I have recently inherited a large Confluence project and to my dismay, I have found a significant amount of duplicated content with random edits that has resulted in inconsistent content.

For instance, there are many notes and alerts as well as paragraphs that I would like to reduce down to a single source copy of each.

Rather than arbitrarily selecting a page to host the master/source copy, I am thinking of creating a "hidden" section dedicated to hosting each source note.  In MadCap Flare terminology, I would call these "Snippets". Then use the Excerpt macro - Excerpt Include or Include Page macros to add the notes to each page,  where required.

In the absence of any respectable content reuse functionality, is this a good practice?

I'm a novice with Confluence so please be gentle. :)

Thank you for your advice.

Matt Reiner _K15t_ · Answer

Hey @Shawn in Van

Maybe this is helpful: https://www.k15t.com/rock-the-docs/documentation-guide/content-reuse

Shawn in Van · Answer

Thanks so much for your valued advice. :)

Nic Brough -Adaptavist- · Answer

Yes, I see that's a bit painful.  Usually is when you inherit someone else's stuff (You wouldn't believe some of the rubbish I've had to unpick from inherited Jira and Confluence systems)

>Much of the content that I wish to reuse is already located inside pages where the entire page is set inside an "Excerpt"

I would want to unpick that, no matter what else you do.  If a whole page is an excerpt, it's a waste of time, that's what "include" is for.

>Most importantly, I would like to move all of the frequently reused notes and alerts out of the pages. I think this content would be easier to manage if were placed in a specific location dedicated to content reuse.

This is exactly what I would do.  Put all the notes and alert stuff into their own space (or maybe two?) and replace their usage with include/excerpts.

If you have lots of pages that would be useful in one block, but containing many snippets, I would think about the two basic options:

* Break out each snippet into its own child page, and make the original page little more that a string of includes
* Look at the multi-excerpt macro in the marketplace.  It does what it sounds like - lets you flag a page with many excerpts rather than the single excerpt Confluence's own allows

Whatever you do, I think you've got a large task in front of you, converting pages to use include/excerpt/multi-excerpt

>What I meant by "hidden"

Not silly at all, it was clear what you were looking for.  Confluence doesn't do that though, you have to make your included pages visible to the users.  Putting them into a dedicated space (and having pages of snippets that don't really hang together themselves) helps the users learn to ignore the snippets sources though, and only read them as part of the target page!