Hi Community, Jessica here from the Confluence Product Marketing team!
July’s community challenge is all about sharing pictures — and as an extension of our first post on what kind of templates you’ve created in Confluence, we thought we’d take this opportunity to actually see those templates!
Post screenshots below (feel free to cross out or remove any sensitive info) to show off your best templates and tell us how they’ve helped improve your work.
We can’t wait to see them!
*IMPORTANT NOTE: there is a known bug with posting images in discussion comments if you try to post an image and nothing else, you get an error. You will need to include some text in addition to the image.
Hi @Jonathan Smith,
What a creative idea! I love how clean, simple and clear these templates are. Thank you for sharing!
Here is the lates template I created. this is a "plugin evaluation" template. We always evaluate market place plugins before we install it in our confluence instance.
here we track user requirement that leads to get a plugin, any substitute plugins and nominated plugin/s for further evaluation based on our selection criteria, functional analysis, test scenario executed and results, technical analysis, anomaly report , risk found and finally a summary of tasks executed so far.
Wow @Alana Fernando,
This template is very clean and well formatted. I was searching for a form such as this, thanks for the inspiration.
:)
Glad you found this useful @[deleted] 😊 !
Also As I mentioned there are much more in to this.
I would be interested to know if you manually test for the above criteria or if you build automated tests, or perhaps even both?
I manually test. As it is just a evaluation (most probably one time thing) I think it is waste of time to script a automation test suit. 😊
Also even for a new 'plugin version evaluation for already existing plugin'; I refuse to script test suits since vendors improve and change the functionalities rapidly and have to change the code time to time. it is much much cheaper to test manually.
Beautiful template, @Alana Fernando!
I love how you used macros to keep everything looking nice and neat. Has it been easy to get other people in your company to start using it too?
My team mates are the people who use this template and they loved it. 😊
Before each release, we will create a Issue for approval in Jira, and the specific content of this release will be reflected in Confluence, linking the Jira and Confluence pages through Issuelinks
Hi @Ollie Guan, great template! Linking between Jira and Confluence is such a great way way to stay organized. We do the same thing here at Atlassian!
What a nice idea @Jessica Lynn
Excited to see how others work.
Here is my latest blueprint: Created to get Processing standards, we are using on all 15 production locations worldwide - digitized, centralized and unified.
To make it comfortable for the non-technical users - I used several variables (dropdown lists) to choose from. You can also see several Macros we used and costumized for this space that tracks who created the document, who worked last on it aso. sorry that everything is in german
We overworked it several times - and I have to say: it was absolutly worth the time we invested. People who first were skeptical love how easy they can create and update those important things. Acceptance is growing!
Totally agree: creating a really good template can be time consuming, but it's almost always worth it in the long run! At Atlassian, our templates save me *so* much time –– both because I don't waste time creating the same page formats over and over again and because our documents are standardized and easy to scan through for information.
I can definitely tell that you put a lot of effort into this template, it's so beautiful and well-organized! I especially like the dropdown lists and that you made an effort to make it accessible for non-technical users. Nice touch!
Thank you @Jessica Lynn - I'm totally with you.
What is another benefit of well-prepared templates, which you work out well that are checked at regular intervals, is that people have to overthink their processes and claims they have to it. We found several points that had absolut first priority that are now gone and not needed anymore :)
Hey Atlassian Team Members, how about you show us some of your secret / non-published templates!
@Jonathan Smith coming atcha soon!
did you ever post anything showing this? if so where?
Here's one that we use to report on the status of large projects.
Each large project gets its own Confluence space with a templatized homepage
The deploy date is reading from a Jira fixVersion date using a custom macro
The status is a custom macro that has pre-defined statuses
All projects get aggregated by team on a single project status page using page properties report macros. More info can be accessed using the expand macro
It seems like a lot of you are fans of the expand macro when it comes to templates! I am too. I think it's really helpful when all or most of the major information in a template is available at a glance and viewers can choose if they want to read more detailed information. Not only does it make your document easier to read through, but I also think it's more pleasing to the eye.
Thanks so much for sharing your template! It looks great!
Wow, I really like that macro that pulls the Version Date! I'm all for not having to update a thousand places when we adjust a release date!
Thanks @Joshua McManus!
Here is a little clip of the macro in action:
And the result:
Code is open source here: https://github.com/msolomonTMG/confluence-jira-deploy-dates-add-on
Hello!
This is my projects' summary page template. The scope of this page is to keep track and on the updates made on each project page and to have the info in a single place.
I used a table and each cell in Project name column has an expand macro/ and excerpt include (bringing here only the update info from the project page, where an issue macro is also present). Details here represents the link to the page. At the beginning, the header also had the sorting feature, which now is gone (no explanation found yet- no merges in the table). The sorting used to be very helpful :(.
The date for the last update is inserted manually and it would really be very helpful if anyone could suggest a macro that would help me just track the last update directly from the updated page. Any other suggestions are welcome.
Hope this could prove helpful for someone :)
Thanks for other inspirational ideas found here!
July
Hi @Iulia Savin,
Love your well-organized template!
Sorry to hear that you've been having trouble sorting your tables by date and thanks for your feedback on the heading sorting feature. Have you considered using the Advanced Tables for Confluence app? One of its features is advanced date sorting so hopefully it helps!
The template I use the most is the one for my Jira or Confluence tutorials:
Very simple but very useful:
And an anonymized screenshot of the main tutorials page to be complete:
Please implement a feature on the API.
"Create a page from a template using API!"
Wow @Manon Soubies-Camy!
What a clever idea for a template. Simple and so easy to read. Thanks so much for sharing!
We use Jira to track our IT assets (servers, workstations, etc). However, we use Confluence to document information about the services on our servers. We use Jira's functionality to link issues to Confluence pages. So, when we have a new service application we create a Confluence page for it and then in Jira we link the server ticket to the Confluence page. Also, any change tasks to the application or servers are linked to the Confluence page as well. I also created a couple user macros that wrap the confluence Jira macro to pull back tickets that are linked to the page that the user macro is placed on. One caveat this requires the ScriptRunner add-on as it uses a JQL function added by that add-on. Below is a screenshot of the template and the user macro code.
With this setup we have a page with a page properties report macro that rolls up all that information so we can see a list of our services, the critically, who owns the service, the server(s) that support that service, and vendor support information. So, in the event of service disruption we have a one-stop-shop for high level information about our service catalog. And if we drill down to a specific service we can see documentation for that service and any work done on it (upgrades, config changes, issue tickets) audited through Jira tickets.
Macro Name:
jira_server_links
Macro Title:
Jira Server Links
Macro Body Processing:
No macro body
Template:
## Developed by: Davin Studer ## Date created: 06/28/2018 ## @noparams <ac:structured-macro ac:name="jira" ac:schema-version="1"> <ac:parameter ac:name="server">{Our Server}</ac:parameter> <ac:parameter ac:name="columns">summary,Production Status</ac:parameter> <ac:parameter ac:name="maximumIssues">1000</ac:parameter> <ac:parameter ac:name="jqlQuery">project = ASSETS AND issuetype = Server AND status = "In Service" AND issueFunction in linkedIssuesOfRemote("query", "pageId=$content.id")</ac:parameter> <ac:parameter ac:name="serverId">{serverid}</ac:parameter> </ac:structured-macro>
Macro Name:
jira_issue_links
Macro Title:
Jira Issue Links
Macro Body Processing:
No macro body
Template:
## Developed by: Davin Studer ## Date created: 06/28/2018 ## @noparams <ac:structured-macro ac:name="jira" ac:schema-version="1"> <ac:parameter ac:name="server">{Our Server}</ac:parameter> <ac:parameter ac:name="columns">key,type,summary,created,status,assignee,reporter</ac:parameter> <ac:parameter ac:name="maximumIssues">1000</ac:parameter> <ac:parameter ac:name="jqlQuery">project = OPSLOG AND issueFunction in linkedIssuesOfRemote("query", "pageId=$content.id") </ac:parameter> <ac:parameter ac:name="serverId">{serverid}</ac:parameter> </ac:structured-macro>
Hi @Davin Studer,
Love to see so many people making use of how well Confluence and Jira can work together! I think your idea of creating a "one-stop shot" for service catalog info is such a good way to make sure you can get things back on track as soon as possible if there's a service disruption. So happy to see that you're using templates to do your best work!
HI,
Love to have an API to create Confluence page based on template.