Thoughts on technology and innovation
Ted Husted, Release Engineer
One of the many truly useful features of the Confluence enterprise wiki are page templates.
Along with Confluence templates for sprint planning, retrospectives, and Go-No-Go decisions, we have checklist templates for routine maintenance, rolling new versions, and even rolling out the next seasonal release.
With Confluence, you can also create any number of specialized spaces, to help organize your content. Given our love of checklists and other artifacts, to keep our spaces from overflowing, we standup a new workspace every four months, to cover each seasonal release (Winter, Spring, and Summer).
So right now, we have separate workspaces for Winter 17 and Spring 17. Next month, Winter 17 will be retired, and we'll standup a shiny new Summer 17 workspace. (To everything there is a season ...)
Confluence templates can be associated with a space, or setup as global templates available to all the spaces. For our seasonal workspaces, the Confluence global templates come in handy, since we can access a global template from any workspace in our site.
While Confluence is a outstanding enterprise wiki, with finely grained permissions, there is a gap when it comes to global templates. To create and edit global templates, you have to be a site-wide administrator. This is a sad gap for us, since we like to keep our checklist templates open for collaborative editing.
Ideally, we'd be able to setup a dedicated space to store shared templates, protected with the usual Confluence permissions.
A handy feature of global templates is that you can attach them to a button and save the new page back to your current space. With a bit of tinkering, I found a link that can create a template defined in another space.
Here, the other space is named "TEMPLATES" and Entity ID is a page key.
You might think that "newSpaceKey" could direct the new page to another site: Alas, it does not. For now, it has to be the same space as the spaceKey, or Confluence complains in no uncertain terms.
While this link does create the template, it doesn't save the new page back to your current space. The new page ends up in the space where the template is defined.
After clicking the link, an easy workaround is to leverage the Confluence user interface, and in a few quick clicks, move the page back to your current space.
Here's the work instruction.
Add a new page from template link
Create a new Shared Template
In whatever space you want to use for shared templates:
Link to a Shared Template
An added benefit is that now you have easy-to-access examples of your templates. You can't link everyone to a global template in Confluence, but if the template is in an shared space, you can link directly to the shared template. Very handy for procedural documentation.
If you need more people to update shared templates, or if you want to link to the current version of a shared template, then this Confluence hack is for you.
Do you have a favorite Confluence hack to share?
Ted Husted is a Kaizen Squad developer on the Nimble AMS product crew. "We make the good changes that create a great product." For more, follow @tedhusted on Twitter.