Hello the community,
I request your help, because we need to create some template to have a global overview of our applications (General information, contact, techno used, db, documentation link...).
I would like to check what are the best practices to create such template and provide a complete set of information in the appropriate way for our IT Team.
Thanks for your help.
I'm not sure if I understand your question precisely. It is quite difficult to give advice to your specific problem without details. Probably you are not asking for specific information, but for a general approach on creating an information architecture based on Confluence.
Basically you could consider the following topics
The tools confluence provides to implement these features are:
So you may add the page properties macro to your template and define the metadata for the type of documents to create with this template (such as product version or release date). Then you may want to mark the content (such as short descriptions or system requirements) that you plan to transclude from other pages (such as overviews). Finally you may want to add sections with related information where a content by label macro will automatically reference information labelled with a given tag.
Since you are listing information like contact information you are probably requiring multiple templates. A contact document instance based on the contact template may then be referenced or transcluded (excerpt in the Confluence terminology) in e.g. a product document instance.
You may have a look at the projectdoc Toolbox, our commercial add-on for Confluence, that provides macros for these and other use case. As a starting point these are the macros of the toolbox that align to the areas I mentioned above:
Personally I prefer blueprints over templates. If you are looking for examples on starting a blueprint add-on project, Confluence Blueprints is a good way to start. Also check out examples on Bitbucket. But as Stephan mentioned, this involves programming a plugin.
If you are looking for more general information, I found Brikit's presentation on Creating a Sound Information Architecture in Confluence very helpful. If you are looking for literature, I would recommend to have a look at Morville, Rosenfeld, and Arango's book "Information Architecture for the World Wide Web".
If you are searching for tools to define a documentation process (e.g. enforce mandatory information), you may need to look for add-ons that support defining workflows. For optimised display you probably want to have a look at theme add-ons such as Brikit Theme Press.
Hope this helps as a starting point!
We asked the same questions back in 2013. Templates are ok, when you have only a few. If you have dozens, then the dialog to choose is a pain. And templates are limited to one page. Blueprints support multi page templates, but you have to write a plugin.
This has meant, that we have developed our own plugin, with which templates and bluerpints are created easily and very rapidly. And for the end user the usage is also very simple - pressing a button and filling out a form.
Try it for free under:
Hello and thanks for your reply, but it's not exactly the answer i'm expecting
More advice on how to create the most appropriate template to manage our internal application information catalog, such as key requirements, information that are mandatory to display and way to optimise the display.
Do you use templates with Confluence? Take part in a remote 1-hr workshop. You'll receive USD $100 for your time! We're looking for people to participate in a remote 1-hr workshop...
Connect with like-minded Atlassian users at free events near you!Find a group
Connect with like-minded Atlassian users at free events near you!
Unfortunately there are no AUG chapters near you at the moment.Start an AUG
You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs