Proposal to add an analytics tool to the documentation site

Introduction

This document describes a proposal for adding analytics to the Apache HTTP Server Documentation website. It is intended as both a proposal and a call for suggestions, comments and critique. Feel free to edit or add anything that you feel would further the discussion.

Motivation

I (Daniel/humbedooh) have been wondering for some time now, how we can improve the site to give the users a better experience and a faster flow from question to answer. In that search, the question of doing a proper facts-based analysis keeps popping up.

What I would essentially like is to be able to look at the flow that happens from when a users has a problem till he/she finds a solution in our documentation (or on our IRC channel or mailing list). We should, as documentation writers, have some idea of whether our efforts are fruitful or not, and whether we can improve pages A, B or C to make it easier for users to search for an answer and find it, but without some form of log files or analytics tool, this becomes quite hard, if not impossible.

I would therefore like to propose that we implement some form of anonymous analysis snippet on our documentation, so that we can figure out some facts:

I believe that if we had these facts sorted out, we could more easily work towards improving our documentation and help people reach the answers to their questions faster.

Privacy

A privacy policy draft has been made, based on the generic privacy policy used by, among others, the Lucene and Directory projects, which can be found at http://wiki.apache.org/httpd/PrivacyPolicy

This policy would be linked to at the bottom of each page incorporated in the analysis.

Requirements

The analytics tools we ultimately decide on should have at least the following solutions/tools:

Suggested analytics tools

Questions

Should such an analysis be extended to the main site as well?

- Can anyone think of what use we would have of also analysing the main site?

What would be the policy for granting access to the analytics data?

- PMC? Committers? Anyone who cares?

- If the privacy policy were to be adopted as is, it would probably restrict us to only allowing committers or PMC.

Add more questions here

DocsAnalyticsProposal (last edited 2012-05-18 18:13:10 by DanielGruno)