Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

  • Global
  • Personal

Recognition

  • Give kudos
  • Received
  • Given

Leaderboard

  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage
Highlighted

Best Practice for Managing Policies, Procedures, Manuals, etc?

We've been using Confluence for a few years to manage all of our company Policies, Procedures, Forms, Training Manuals and more, but theres got to be a better way to do it.

Our current problem is duplicate content.

We have spaces broken into departments like, HR Policies Space, HR Procedures Space, Finance Policies Space, Finance Procedures Space, and so on. The problem comes in when users need to include a Policy or Procedure or Form inside another space.

Example: Our Employee Manual is its own space that contains tons of duplicate pages from all other spaces. Whenever a change is made on the original page in HR Policies, its up to the user to search out all the duplicates in manuals and make that same change.

Theres got to be a better way.

I would think a better option would be to embed the entire page of the HR Policy they are trying to use in the Employee manual, that way if a change is made to the original, it is mirror to all the manuals because its embedded. But I don't think you can even embed a page like this.

Does anyone have any better ideas?

1 comment

This is exactly why Confluence has always had an "include" macro.

When you identify a duplicate, delete the entire body of the duplicate and replace it with a simple "include: source of truth" macro.

This is what I needed. Thanks a ton!

 Any suggestions as to the best structure to use?

Instead of us having 75 different spaces for "HR Policies", "HR Procedures", "Finance Policies", etc... I think it might be better to have 1 space that has all Policies and Procedures within it and then each space just uses that macro to organize those pages into other spaces?

Peter DeWitt Community Leader Nov 08, 2017

"Instead of us having 75 different spaces for "HR Policies", "HR Procedures", "Finance Policies", etc... I think it might be better to have 1 space that has all Policies and Procedures within it and then each space just uses that macro to organize those pages into other spaces?"  - I think this is the way to go.  I have used a similar approach for team status updates.  One space for the Status updates and includes back to the team spaces where each team can keep their own status up to date.

 

.pd

In addition to the Include Macro Nic mentioned you could also use the Excerpt Macro and the Excerpt Include Macro in case you need to reuse only one part of a page.

In case you have even more complex single sourcing requirements, you could use a third party plugin that supports multi-excerpt.

Davin Studer Community Leader Nov 10, 2017

Related to the multi-excerpt macro that Robert mentioned is a free offering that does the same thing. It called the Include Content add-on.

Comment

Log in or Sign up to comment
TAGS
Community showcase
Posted in Confluence

What do you think is the most *delightful* Confluence feature? Comment for a prize!

- Create your own custom emoji 🔥 - "Shake for Feedback" on mobile 📱 - An endless supply of GIFs via GIPHY 🤩 Is there anything quite as nice as a pleasant surprise? Comment below with what...

402 views 23 8
Join discussion

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you