summaryrefslogtreecommitdiffstats
path: root/l10n-en-GB/toolkit/toolkit/about/aboutGlean.ftl
diff options
context:
space:
mode:
Diffstat (limited to 'l10n-en-GB/toolkit/toolkit/about/aboutGlean.ftl')
-rw-r--r--l10n-en-GB/toolkit/toolkit/about/aboutGlean.ftl107
1 files changed, 107 insertions, 0 deletions
diff --git a/l10n-en-GB/toolkit/toolkit/about/aboutGlean.ftl b/l10n-en-GB/toolkit/toolkit/about/aboutGlean.ftl
new file mode 100644
index 0000000000..0974cf7c6a
--- /dev/null
+++ b/l10n-en-GB/toolkit/toolkit/about/aboutGlean.ftl
@@ -0,0 +1,107 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+### "FOG", "Glean", and "Glean SDK" should remain in English.
+
+-fog-brand-name = FOG
+-glean-brand-name = Glean
+glean-sdk-brand-name = { -glean-brand-name } SDK
+glean-debug-ping-viewer-brand-name = { -glean-brand-name } Debug Ping Viewer
+about-glean-page-title2 = About { -glean-brand-name }
+about-glean-header = About { -glean-brand-name }
+about-glean-interface-description =
+ The <a data-l10n-name="glean-sdk-doc-link">{ glean-sdk-brand-name }</a>
+ is a data collection library used in { -vendor-short-name } projects.
+ This interface is designed to be used by developers and testers to manually
+ <a data-l10n-name="fog-link">test instrumentation</a>.
+about-glean-upload-enabled = Data upload is enabled.
+about-glean-upload-disabled = Data upload is disabled.
+about-glean-upload-enabled-local = Data upload is enabled only for sending to a local server.
+about-glean-upload-fake-enabled =
+ Data upload is disabled,
+ but we’re lying and telling the { glean-sdk-brand-name } it is enabled
+ so that data is still recorded locally.
+ Note: If you set a debug tag, pings will be uploaded to the
+ <a data-l10n-name="glean-debug-ping-viewer">{ glean-debug-ping-viewer-brand-name }</a> regardless of settings.
+# This message is followed by a bulleted list.
+about-glean-prefs-and-defines = Relevant <a data-l10n-name="fog-prefs-and-defines-doc-link">preferences and defines</a> include:
+# Variables:
+# $data-upload-pref-value (String): the value of the datareporting.healthreport.uploadEnabled pref. Typically "true", sometimes "false"
+# Do not translate strings between <code> </code> tags.
+about-glean-data-upload = <code>datareporting.healthreport.uploadEnabled</code>: { $data-upload-pref-value }
+# Variables:
+# $local-port-pref-value (Integer): the value of the telemetry.fog.test.localhost_port pref. Typically 0. Can be negative.
+# Do not translate strings between <code> </code> tags.
+about-glean-local-port = <code>telemetry.fog.test.localhost_port</code>: { $local-port-pref-value }
+# Variables:
+# $glean-android-define-value (Boolean): the value of the MOZ_GLEAN_ANDROID define. Typically "false", sometimes "true".
+# Do not translate strings between <code> </code> tags.
+about-glean-glean-android = <code>MOZ_GLEAN_ANDROID</code>: { $glean-android-define-value }
+# Variables:
+# $moz-official-define-value (Boolean): the value of the MOZILLA_OFFICIAL define.
+# Do not translate strings between <code> </code> tags.
+about-glean-moz-official = <code>MOZILLA_OFFICIAL</code>: { $moz-official-define-value }
+about-glean-about-testing-header = About Testing
+# This message is followed by a numbered list.
+about-glean-manual-testing =
+ Full instructions are documented in the
+ <a data-l10n-name="fog-instrumentation-test-doc-link">{ -fog-brand-name } instrumentation testing docs</a>
+ and in the <a data-l10n-name="glean-sdk-doc-link">{ glean-sdk-brand-name } documentation</a>,
+ but, in short, to manually test that your instrumentation works, you should:
+# This message is an option in a dropdown filled with untranslated names of pings.
+about-glean-no-ping-label = (don’t submit any ping)
+# An in-line text input field precedes this string.
+about-glean-label-for-tag-pings = In the preceding field ensure there is a memorable debug tag so you can recognise your pings later.
+# An in-line text input field precedes this string.
+about-glean-label-for-tag-pings-with-requirements = Set a memorable debug tag <span>(20 characters or fewer, alphanumerics and - only)</span> so you can recognise your pings later.
+# An in-line drop down list precedes this string.
+# Do not translate strings between <code> </code> tags.
+about-glean-label-for-ping-names =
+ Select from the preceding list the ping your instrumentation is in.
+ If it’s in a <a data-l10n-name="custom-ping-link">custom ping</a>, choose that one.
+ Otherwise, the default for <code>event</code> metrics is
+ the <code>events</code> ping
+ and the default for all other metrics is
+ the <code>metrics</code> ping.
+# An in-line check box precedes this string.
+about-glean-label-for-log-pings =
+ (Optional. Check the preceding box if you want pings to also be logged when they are submitted.
+ You will additionally need to <a data-l10n-name="enable-logging-link">enable logging</a>.)
+# Variables
+# $debug-tag (String): The user-set value of the debug tag input on this page. Like "about-glean-kV"
+# An in-line button labeled "Apply settings and submit ping" precedes this string.
+about-glean-label-for-controls-submit =
+ Press the preceding button to tag all { -glean-brand-name } pings with your tag and submit the selected ping.
+ (All pings submitted from then until you restart the application will be tagged with
+ <code>{ $debug-tag }</code>.)
+about-glean-li-for-visit-gdpv =
+ <a data-l10n-name="gdpv-tagged-pings-link">Visit the { glean-debug-ping-viewer-brand-name } page for pings with your tag</a>.
+ It shouldn’t take more than a few seconds from pushing the button to your ping arriving.
+ Sometimes it may take a small handful of minutes.
+# Do not translate strings between <code> </code> tags.
+about-glean-adhoc-explanation =
+ For more <i>ad hoc</i> testing,
+ you can also determine the current value of a particular piece of instrumentation
+ by opening a devtools console here on <code>about:glean</code>
+ and using the <code>testGetValue()</code> API like
+ <code>Glean.metricCategory.metricName.testGetValue()</code>.
+# Do not translate strings between <code> </code> tags.
+about-glean-adhoc-explanation2 =
+ For more <i>ad hoc</i> testing,
+ you can also determine the current value of a particular piece of instrumentation
+ by opening a devtools console here on <code>about:glean</code>
+ and using the <code>testGetValue()</code> API like
+ <code>Glean.metricCategory.metricName.testGetValue()</code>
+ for a metric named <code>metric.category.metric_name</code>.
+# Do not translate strings between <code> </code> tags.
+about-glean-adhoc-note =
+ Please note that you are using the Glean JS API by using the devtools console.
+ This means the metric category and metric name are formatted in
+ <code>camelCase</code> unlike in the Rust and C++ APIs.
+controls-button-label-verbose = Apply settings and submit ping
+about-glean-about-data-header = About Data
+about-glean-about-data-explanation =
+ To browse the list of collected data, please consult the
+ <a data-l10n-name="glean-dictionary-link">{ -glean-brand-name } Dictionary</a>.