Reshaping Piwik Documentation

In this post you will hear all about what has recently been happening at Piwik: a new, simpler to use User Documentation now available at piwik.org/docs

Check out the new docs pages…

Using Piwik…

• Piwik Installation & Optimization

This is all the information needed to install and keep Piwik up and running such as: How to download and install Piwik, how to set-up auto archiving, how to update Piwik, knowing which version of Piwik is the latest and which bugs were corrected in which release.

• User Guide

This encompasses all the questions related to Piwik tracking system and its user interface: How to setup a website so it is tracked by Piwik, how to track campaigns and goals, how to use the dashboard, how to export reports and how to manage sites and users.

• Piwik Integration

This section is about integration tasks such as: How statistics can be exported through the API, how a widget can be integrated in a separate website and how Piwik can be packaged in another application.

Enhancing Piwik

• Participate in the Piwik project

Both technical and non-technical, this section is about what is being and can be done to improve and develop Piwik: Translations, open source development process, quality standards, security, technical specifications, bug/feature requests and marketing effort.

• Plugin development

This section is about mastering Piwik analytical framework to develop new features via plugins. It holds the complete framework reference and tutorials.

Finding the appropriate organization

We decided to classify all the help content into two main sections:

1. ‘Using Piwik‘. This section provides material to help mastering Piwik installation, optimization, tracking and advanced functionalities such as remote access to analytical data.
2. ‘Enhancing Piwik‘, relates to how Piwik evolves thanks to its community. It also includes a plugin development section.

The documentation will evolve in the next few weeks.

Feedback on documentation pages

To help with making documentation as useful as we can, we added a ‘Feedback form’ at the bottom of each documentation page, so feel free to post a suggestion, correction or question.

As always we value feedback from users so feel free to comment any aspect of the new organization and missing/outdated/imprecise material.

What’s next?

We are currently working on providing more content in the User Guide section by including topics such as campaign tracking and websites management.

We are actively looking for a Documentation lead! If you are a Piwik user, who is a native English speaker and loves to write, you could help maintaining and improving our help content. If you wish to contribute documentation, please read this page

Happy analysis!