From 9bed880865edf35a978c56f752e73fc936caeeab Mon Sep 17 00:00:00 2001
From: diosmosis <benaka@piwik.pro>
Date: Mon, 8 Jun 2015 21:15:03 -0700
Subject: [PATCH] Add documentation for VisitLastActionTime dimension since
 it's name is misleading. Though it is initially set to the start time of a
 visit's last action, it is supposed to represent the visit's actual end time.

---
 plugins/CoreHome/Columns/VisitLastActionTime.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/plugins/CoreHome/Columns/VisitLastActionTime.php b/plugins/CoreHome/Columns/VisitLastActionTime.php
index d25f09abab..15e6ea8867 100644
--- a/plugins/CoreHome/Columns/VisitLastActionTime.php
+++ b/plugins/CoreHome/Columns/VisitLastActionTime.php
@@ -15,6 +15,14 @@ use Piwik\Tracker\Request;
 use Piwik\Tracker;
 use Piwik\Tracker\Visitor;
 
+/**
+ * This dimension holds the best guess for a visit's end time. It is set the last action
+ * time for each visit. `ping=1` requests can be sent to update the dimension value so
+ * it can be a more accurate guess of the time the visitor spent on the site.
+ *
+ * Note: though it is named 'visit last action time' it actually refers to the visit's last action's
+ * end time.
+ */
 class VisitLastActionTime extends VisitDimension
 {
     protected $columnName = 'visit_last_action_time';
-- 
GitLab