Today the smartics Integration for Piwiki has been released as an add-on for Confluence! The add-on is available on the Atlassian Marketplace for free.
Piwik is the leading open-source analytics platform that gives you more than just powerful analytics. Confluence is your platform where work becomes teamwork. This add-on makes integrating calls to the Piwik API from your Confluence pages much easier!
Instead of adding HTML and JavaScript code to a page, simply add a macro and provide the API call information.
With this Add-on
Using our macros allows you to simply add your information via a dialog:
The macro will take care for rendering the JavaScript snippet inside of the HTML script tag.
Currently integration to Piwik is supported by the following macros:
- Document Properties
- Provide document properties to the Piwik context.
- Set Multiple Custom Variables
- Provide a set of custom variables to the Piwik context.
- Set One Custom Variable
- Provide a single custom variable to the Piwik context.
Please visit the homepage of the add-on for instructions on integrating Piwik into your Confluence instance!
Lost in wiki space? Blank-Wikipage-Syndrome?
Where to add? How to find? No fun anymore?
Today we added an introduction to projectdoc in four steps.
We already had an introduction to projectdoc to introduce projectdoc in brief to potential customers. The new introduction focuses on new users and especially gives more detailed information on the projectdoc basics to get started.
Please refer to The projectdoc Toolbox for Atlassian Confluence for more information on projectdoc!
Or watch this introduction video on YouTube!
Please not that this video has sounds on, just in case you are in your office!
Step through this presentation at you own pace: Prezi presentation.
Lost in wiki space? Blank-Wikipage-Syndrome? Where to add? How to find? No fun anymore?
projectdoc teaser
Our claim is that projectdoc enhances your documentation experience as a team. projectdoc is based on projectdoc documents. A projectdoc document is a Confluence page using document properties and sections. This is contrary to starting every page with the Confluence blank page, which seems fast and easy.
You now may wonder –
Does this additional effort actually pay off?
We say –
YES!
Let's check our arguments ... (TL;DR)
Your Investment
Let's first have a look on what your investment is. Who has to do what at which time?
Defining a Document
This is what you have to do to define a projectdoc document:
- Add the Document Properties Marker Macro to define document properties
- For each section of your document use the Section Macro
The Impact on your Work
Once you build your documentation with projectdoc documents, you can rely on the following features.
Select Documents
With properties and sections defined in a document, authors may employ the autolist feature (e.g. the Display Table Macro) to select and list documents.
Select documents by their properties and display properties and sections of the selected documents.
The impact of this feature on your work is better navigation, since links that refer to related information are collected and displayed easily. New pages that match the constraints will be added automatically without having to edit the referring page. This increases maintainability!
Transclude Sections and Properties
Modular documentation supports reuse and collaboration for your team.
Transclusion of information (i.e. include information from another page) supports single-sourcing (i.e. have information in one and only one place).
Use the Transclusion Macro or the Transclude Documents Macro to transclude sections and the display property macros (e.g. Display Document Property Macro or Display Document Properties Macro) to transclude property values.
The feature impacts on easier collaboration. Smaller documents are more easily written and maintained independently. This supports teams to create documentation collaboratively. In addition to that information fragments may be transcluded at multiple locations, which again supports maintainability since changes are applied at one location.
