[Rt-commit] rt branch, 5.0/chartjs-documentation, created. rt-5.0.0alpha1-457-g370c2e7c43

Craig Kaiser craig at bestpractical.com
Tue May 19 10:42:40 EDT 2020


The branch, 5.0/chartjs-documentation has been created
        at  370c2e7c4324838148489af8bb145881b3302f89 (commit)

- Log -----------------------------------------------------------------
commit ec6509c0fa472d98f80018b55eed4c244ad852d9
Author: Craig Kaiser <craig at bestpractical.com>
Date:   Mon Mar 30 08:50:26 2020 -0400

    Update chart docs for chartjs

diff --git a/docs/charts.pod b/docs/charts.pod
index 30b9ba69a5..6c85ca4eff 100644
--- a/docs/charts.pod
+++ b/docs/charts.pod
@@ -12,14 +12,22 @@ came in RT 4.2. If you're running a version of RT earlier than
 
 =head1 Enabling Charts
 
+=head2 C<$EnableJSChart>
+
+By default this option is enabled, if you'd like to disable JS charting
+then you can set this configuration value to false. To use GD charts
+instead of JS charts ensure that the C<--enable-gd> option is being
+used.
+
 =head2 Installing GD
 
-While charts is a core part of RT, you do need to enable it using
-the C<--enable-gd> option and install the required dependencies when
-you install RT. If you didn't originally install with this flag, you can
-enable it by re-running the L<< C<configure> >> script from the RT
-distribution (including all previous options passed to it originally)
-or doing the following in your current install:
+While charts is a core part of RT, if you want to use GD charting in place
+of JS charting then you do need to enable GD it using the C<--enable-gd>
+option and install the required dependencies when you install RT.
+If you didn't originally install with this flag, you can enable it by
+re-running the L<< C<configure> >> script from the RT distribution
+(including all previous options passed to it originally) or doing the
+following in your current install:
 
 =over
 
diff --git a/docs/images/dashboard-chart.png b/docs/images/dashboard-chart.png
index 51013e7c90..d798864e88 100644
Binary files a/docs/images/dashboard-chart.png and b/docs/images/dashboard-chart.png differ
diff --git a/docs/images/general-owner-chart.png b/docs/images/general-owner-chart.png
index 56e429ea9d..836d23a09f 100644
Binary files a/docs/images/general-owner-chart.png and b/docs/images/general-owner-chart.png differ
diff --git a/docs/images/general-owner-lastupdated-chart.png b/docs/images/general-owner-lastupdated-chart.png
index 54f3f49e19..65cb5f0657 100644
Binary files a/docs/images/general-owner-lastupdated-chart.png and b/docs/images/general-owner-lastupdated-chart.png differ
diff --git a/docs/images/general-status-chart.png b/docs/images/general-status-chart.png
index 3d208f9013..90690f0b57 100644
Binary files a/docs/images/general-status-chart.png and b/docs/images/general-status-chart.png differ
diff --git a/docs/images/queue-created-started-chart.png b/docs/images/queue-created-started-chart.png
index b0aa833869..1b52c2220a 100644
Binary files a/docs/images/queue-created-started-chart.png and b/docs/images/queue-created-started-chart.png differ

commit 370c2e7c4324838148489af8bb145881b3302f89
Author: Jim Brandt <jbrandt at bestpractical.com>
Date:   Tue May 19 09:48:42 2020 -0400

    Note big change to charts in 5.0

diff --git a/docs/charts.pod b/docs/charts.pod
index 6c85ca4eff..658a97832e 100644
--- a/docs/charts.pod
+++ b/docs/charts.pod
@@ -7,17 +7,25 @@ last year?) to regular status reports that you then include in
 shared dashboards that everyone can see.
 
 RT has had charts for a long time, but many significant improvements
-came in RT 4.2. If you're running a version of RT earlier than
-4.2 some options and features described here may not be available.
+were made in RT 4.2. Another significant change was made in RT 5.0
+when we converted the web chart library to Chart.js.
 
 =head1 Enabling Charts
 
 =head2 C<$EnableJSChart>
 
-By default this option is enabled, if you'd like to disable JS charting
-then you can set this configuration value to false. To use GD charts
-instead of JS charts ensure that the C<--enable-gd> option is being
-used.
+Starting in RT 5.0, by default charts are rendered by Chart.js,
+a javascript charting library. If you'd like to disable javascript
+rendered charts, you can set this configuration value to false. To use
+GD charts instead of JS charts, set the C<--enable-gd> option
+when running the configure script to install RT.
+
+If you send charts in dashboards via email, GD is still used to
+generate embedded chart images for email. If GD isn't available,
+users can click on the link in email and view charts in RT.
+However, the chart in RT will then show data based on the time
+you click rather than capturing ticket data at the time the email
+was generated.
 
 =head2 Installing GD
 

-----------------------------------------------------------------------


More information about the rt-commit mailing list